当前位置：首页 > news >正文

C++ 日志库 spdlog 使用教程

news 2025/7/6 14:26:25

Spdlog是一个快速、异步、线程安全的C++日志库，他可以方便地记录应用程序的运行状态，并提供多种输出格式。官网：https://github.com/gabime/spdlog

安装教程可以参考：https://blog.csdn.net/Harrytsz/article/details/144887297

Spdlog的优点：

只包含头文件
速度很快
无需依赖第三方库
支持跨平台
支持多线程—线程安全
可对日志文件进行循环输出
可每日生成日志文件
可支持控制台日志输出
可选的异步输出
可定义日志格式

1、日志级别

trace = SPDLOG_LEVEL_TRACE // 最低级（用来记录代码执行轨迹）
debug = SPDLOG_LEVEL_DEBUG //      （用来记录debug信息）
info = SPDLOG_LEVEL_INFO   // 在上面的测试例子中用过
warn = SPDLOG_LEVEL_WARN
err = SPDLOG_LEVEL_ERROR
critical = SPDLOG_LEVEL_CRITICAL
off = SPDLOG_LEVEL_OFF     // 最高级

2、控制台打印日志

方式一，最简单的使用方式，将日志输出到控制台。

#include <iostream>
#include <spdlog/spdlog.h>
#include <spdlog/sinks/stdout_color_sinks.h>void stdout_easy()
{// 根据参数，在内部创建了一个名为 "console" 的 logger，返回 logger 的智能指针。auto console = spdlog::stdout_color_mt("console");// 通过智能指针调用 logger 对象的函数。console->info("hello world");
}
int main()
{stdout_easy();return 0;
}

输出结果：
在这里插入图片描述

方式二，

#include <iostream>
#include <spdlog/spdlog.h>
#include <spdlog/sinks/stdout_color_sinks.h>void stdout_example() {// create a color multi-threaded logger// spdlog::stdout_color_mt("console")函数创建一个名字为console的console logger，// 把这个 logger 注册到 spdlog 的全局注册表中，并且返回指向这个 logger 的指针（shared_ptr）auto console_stdout = spdlog::stdout_color_mt("console");// 如果我们不知道上方创建函数返回的指针，我们也可以直接通过 logger 名称来获取对应 logger // 通过 get 来获取已经创建好的 logger，获取方式通过指针名，同时使用 info 函数输出日志内容spdlog::get("console")->info("loggers can be retrieved from a global registry using the spdlog::get(logger_name)");
}int main() {stdout_example();return 0;
}

输出结果：
在这里插入图片描述

3、保存日志文件

下面的案例将日志记录保存到文件中，以便于长久保存。basic_logger_mt 只是 spdlog 中封装的其中一个日志记录器，还有很多其他的记录器。

#include<iostream>
#include<spdlog/spdlog.h>
#include <spdlog/sinks/basic_file_sink.h>int main() {// 创建一个名为 basic_logger 的日志记录器，并且返回指针。// mt 表示多线程,意味着多个线程中使用同一个日志记录器。// 需要注意的是在文件内添加数据是通过追加的形式进行的，并且如果没有创建文件会自动创建文件。auto basic_logger = spdlog::basic_logger_mt("basic_logger", "./logs/basic_log.txt");for (int i = 0; i < 10000; i++) {basic_logger->info("Test file logger{}", i);}return 0;
}

在这里插入图片描述

4、自定义日志记录器

我们根据以上的学习之后，大体了解了其中的运行机制，所以我们就可以不使用他封装的日志记录器，而是使用他内部的 logger 对象封装适合自己的日志记录器。

需要注意的是，所谓的不同的日志记录器其实就是不同的 logger 对象，那么用什么来区分不同的 logger 对象呢，就是用创建logger对象时传入的参数 sink 对象，这个sink对象标记着不同的类型，把他作为参数 logger 会根据 sink 对象类型的不同创建不同的日志记录器。

这种方式有很大的用途，比如我们可以创建一个日志记录器，但是里边有多个类型的 sink，从而可以一个 logger 能够实现多种效果。

#include<iostream>
#include<spdlog/spdlog.h>
//#include <spdlog/sinks/stdout_sinks.h>
#include <spdlog/sinks/stdout_color_sinks.h>void make_console_spdlog() {/*auto console_level = std::make_shared<spdlog::sinks::stdout_sink_mt>();*/    // 黑白日志auto console_level = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();  // 彩色日志auto console = std::make_shared<spdlog::logger>("console", console_level);console->info("hello world");
}int main() {make_console_spdlog();return 0;
}

输出结果：
在这里插入图片描述

注意：通过手动创建的日志记录器是无法通过名字在 spdlog 中进行查找的，因为他并没有注册到 spdlog 的全局注册表。

void make_console_spdlog() {auto console_level = std::make_shared<spdlog::sinks::stdout_sink_mt>();auto console = std::make_shared<spdlog::logger>("console", console_level);// 直接使用这种方式去获取日志记录器发生错误spdlog::get("console")->info("hello world!");
}

所以在创建日志记录器完成后，要将其注册到spdlog的全局注册表中。

#include<iostream>
#include<spdlog/spdlog.h>
#include <spdlog/sinks/stdout_color_sinks.h>void make_console_spdlog() {auto console_level = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();auto console = std::make_shared<spdlog::logger>("console", console_level);// 将创建的日志记录器注册到全局注册表中spdlog::register_logger(console);spdlog::get("console")->info("hello world!");
}int main() {make_console_spdlog();return 0;
}

5、多记录器共享文件

#include <iostream>
#include <spdlog/spdlog.h>
#include <spdlog/sinks/basic_file_sink.h>void multi_file_write()
{// 创建filesink，以便多个日志共享器共享。auto filesink = std::make_shared<spdlog::sinks::basic_file_sink_mt>("./logs/multilogger.txt");// 创建两个日志记录器来进行测试auto onelogger = std::make_shared<spdlog::logger>("onelogger", filesink);auto twologger = std::make_shared<spdlog::logger>("twologger", filesink);// 注册进spdlog的全局注册表spdlog::register_logger(onelogger);spdlog::register_logger(twologger);for (int i = 0; i < 100; i++) {onelogger->info("onelogger write:{}", i);twologger->info("twologger write:{}", i);}
}int main() {multi_file_write();return 0;
}

在这里插入图片描述

6、日志分割

在我们的应用程序有很多日志需要记录时，每个日志文件就会变得非常大，这样就会影响应用程序的性能以及稳定性。所以为了解决这个问题，可以使用Spdlog的日志分割功能。

rotating log 滚动日志，当日志文件超出规定大小时，会删除当前日志文件中所有内容，重新开始写入

#include<iostream>
#include<spdlog/spdlog.h>
#include <spdlog/sinks/rotating_file_sink.h>void rotaing_file() {// 首先定义要使用分割文件的大小和数量int max_size = 1048576 * 5;int file_size = 3;// 创建 rotaing_logger_mt 日志记录器auto rotaing_file = spdlog::rotating_logger_mt("rotaing_file", "./logs/rotaingLogger.txt", max_size, file_size);for (int i = 0; i < 100000; i++) {rotaing_file->info("rotaing file:{}", i);}
}int main() {rotaing_file();return 0;
}

7、定时日志

Spdlog还可以实现定时创建文件存储日志的功能。

#include<iostream>
#include<spdlog/spdlog.h>
#include <spdlog/sinks/daily_file_sink.h>void daily_log() {// 创建daily_log日志// 参数介绍 1日志记录器名称 2文件名 3时 4分auto daily_log = spdlog::daily_logger_mt("daily_log", "./logs/daily_log.txt", 16, 18);for (int i = 0; i < 100000; i++) {daily_log->info("daily log print {}", i);}
}int main() {daily_log();return 0;
}

8、记录器包含多个 sink

#include<iostream>
#include<spdlog/spdlog.h>
#include<spdlog/sinks/stdout_color_sinks.h>
#include<spdlog/sinks/basic_file_sink.h>void multi_sink() {// 创建两个sink，一个用于控制台输出，一个用于文件输出auto console_sink = std::make_shared<spdlog::sinks::stdout_color_sink_mt>();auto file_sink = std::make_shared<spdlog::sinks::basic_file_sink_mt>("./logs/multi_sink.txt");// 设置两者输出等级console_sink->set_level(spdlog::level::info);file_sink->set_level(spdlog::level::debug);// 将两种不同的sink放到一个日志输出器中auto multi_sink = std::make_shared<spdlog::logger>("multi_sink", spdlog::sinks_init_list({ console_sink, file_sink }));multi_sink->set_level(spdlog::level::debug);// 输出不同等级日志测试multi_sink->info("hello world info");multi_sink->debug("hello world debug");
}int main() {multi_sink();return 0;
}

9、其他介绍

通过上面的学习，我们学会了 spdlog 其函数的基本使用方式，下面对 spdlog 中常用的一些函数和类进行介绍。

level_enum：日志等级枚举，包括trace、info、debug、warn、err、critical、off、n_levels。
sink：日志记录槽，进行底层操作（比如格式化内容，输出内容到控制台/文件）的类。spdlog自带的几种sinks已经能满足日常需求，也可以派生其基类设计新的 sink 以满足特殊的需求。sink类主要使用的函数包括：
- set_pattern(const std::string&)：设置日志输出格式。
- set_level(level_enum)：设置日志输出的最低等级。
- log(log_msg)：由logger自动调用，外部不会主动调用。
logger：日志记录器，被顶层调用来输出日志的类。一个logger对象中存储有多个sink，当调用logger的日志输出函数时，logger会调用自身存储的所有sink对象的log(log_msg)函数进行输出。与自身的sink对应，spdlog也自带了几种logger。logger类主要使用的函数包括：
- set_pattern(const std::string&)：设置logger包括的所有sink的日志输出内容格式。
- set_level(level_enum)：设置logger日志输出最低等级，如果logger包含的sink没有设置日志等级的话，则会为其设置日志等级。
- log(level_enum level, log_msg content)：按照level等级进行输出content，logger其中日志输出最低等级小于或等于level的sink会执行输出操作。
- info(content, arg1, arg2…)：按照trace等级进行输出，输出内容由content与后面的采纳数格式化组成。荣磊的函数还包括debug/trace/warn…。
st/mt：对象版本，spdlog 中 logger 对象和 sink 对象都有两种版本，一种是以 st 结尾的单线程版本，以及以 mt 结尾的多线程版本。
- st：单线程版本，不用加锁，效率更高。
- mt：多线程版本，用于多线程程序是线程安全的。