spdlog C++日志库的快速配置和使用方法

一、简介

spdlog是一个快速、异步的C++日志库，它具有简单易用、高效稳定的特点，在应用程序中得到广泛应用。本文将介绍spdlog的快速配置和使用方法，帮助大家更好地使用该库。

二、安装spdlog

在开始使用spdlog之前，我们需要安装它。spdlog可以通过源代码或者包管理器（例如apt-get、yum、brew等）进行安装。以下是通过源代码进行安装的步骤：

$ git clone https://github.com/gabime/spdlog.git
$ cd spdlog
$ mkdir build && cd build
$ cmake ..
$ make -j
$ sudo make install

在安装完成之后，我们需要在应用程序中引入spdlog头文件：

#include "spdlog/spdlog.h"

三、创建一个基础的日志器

我们可以通过以下代码创建一个基础的日志器：

#include "spdlog/spdlog.h"
 
int main() {
    // 创建一个日志器，并设置全局日志等级
    spdlog::set_level(spdlog::level::debug);
    auto logger = spdlog::stdout_logger_mt("console");
 
    // 写入日志信息
    logger->debug("debug message");
    logger->info("info message");
    logger->warn("warn message");
    logger->error("error message");
 
    return 0;
}

以上代码中，我们首先使用`spdlog::set_level`函数设置全局日志等级，然后使用`spdlog::stdout_logger_mt`创建一个名字为“console”的日志器。接下来，使用`logger->debug/info/warn/error`等函数分别写入不同级别的日志信息。

四、写入日志文件

我们可以通过以下代码将日志信息写入文件：

#include "spdlog/spdlog.h"
 
int main() {
    // 创建一个文件日志器，并设置全局日志等级
    spdlog::set_level(spdlog::level::debug);
    auto logger = spdlog::basic_logger_mt("basic_logger", "logs/basic-log.txt");
 
    // 写入日志信息
    logger->debug("debug message");
    logger->info("info message");
    logger->warn("warn message");
    logger->error("error message");
 
    return 0;
}

以上代码中，我们使用`spdlog::basic_logger_mt`创建一个名字为“basic_logger”的文件日志器，并将日志信息写入“logs/basic-log.txt”文件中。

五、异步日志

默认情况下，spdlog是同步写入日志的，即写入操作会立即完成，这可能会影响程序的性能。我们可以使用异步日志的方式来写入日志，这样可以提高程序的性能。以下是异步日志的示例代码：

#include "spdlog/spdlog.h"
 
int main() {
    // 创建异步日志器，并设置全局日志等级
    spdlog::set_level(spdlog::level::debug);
    auto console_sink = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();
    auto file_sink = std::make_shared<spdlog::sinks::simple_file_sink_mt>("logs/async-log.txt");
    spdlog::sinks_init_list sink_list = {console_sink, file_sink};
    auto logger = std::make_shared<spdlog::async_logger>("async_logger", sink_list, spdlog::thread_pool(), spdlog::async_overflow_policy::block);
 
    // 写入日志信息
    logger->debug("debug message");
    logger->info("info message");
    logger->warn("warn message");
    logger->error("error message");
 
    return 0;
}

以上代码中，我们首先使用`std::make_shared`方法创建了一个控制台和文件两个sink，并将它们添加到`sink_list`中。然后使用`spdlog::async_logger`创建一个名字为“async_logger”的异步日志器，并将`sink_list`作为第二个参数传入。最后，通过`logger->debug/info/warn/error`等函数分别写入不同级别的日志信息。

六、多线程日志

在多线程环境下，我们可以使用以下代码创建一个线程安全的日志器：

#include "spdlog/spdlog.h"
 
int main() {
    // 创建一个多线程日志器，并设置全局日志等级
    spdlog::set_level(spdlog::level::debug);
    auto logger = spdlog::rotating_logger_mt("rotating_logger", "logs/rotating-log.txt", 1048576, 5);
    logger->flush_on(spdlog::level::warn);
 
    // 写入日志信息
    logger->debug("debug message");
    logger->info("info message");
    logger->warn("warn message");
    logger->error("error message");
 
    return 0;
}

以上代码中，我们使用`spdlog::rotating_logger_mt`创建一个名字为“rotating_logger”的线程安全日志器，并将日志信息写入“logs/rotating-log.txt”文件中。此外，使用`logger->flush_on(spdlog::level::warn)`设置日志级别，即在写入warn及更严重级别的日志信息时，就会自动刷新缓冲区。

七、总结

本文介绍了spdlog C++日志库的快速配置和使用方法，包括创建基础日志器、写入日志文件、异步日志、多线程日志等。希望通过本文的介绍，可以帮助大家更好地使用该库，提高应用程序的性能。