【C++】spdlog基础使用

目录

一、基础入门：最简单的日志输出

二、核心：创建不同类型的日志器

1. 控制台日志器（带颜色）

2. 基础文件日志器（直接写入文件）

3. 轮转文件日志器（按大小 / 日期分割）

4. 异步日志器（高性能）

三、日志级别控制

四、自定义日志格式

常用占位符

代码示例

五、同时输出到控制台和文件

六、其他常用接口

一、基础入门：最简单的日志输出

#include <spdlog/spdlog.h> int main() { // 1. 直接使用全局默认日志器打印（默认输出到控制台） spdlog::info("这是一条普通信息"); spdlog::debug("这是一条调试信息"); // 默认级别是 info，debug 默认不会显示 spdlog::warn("这是一条警告信息"); spdlog::error("这是一条错误信息"); spdlog::critical("这是一条致命错误信息"); // 2. 支持 fmt 格式化语法（和 printf 类似，但更安全） int code = 404; std::string path = "/api/user"; spdlog::error("请求失败，错误码：{}，路径：{}", code, path); return 0; }

二、核心：创建不同类型的日志器

spdlog 的核心是「日志器（logger）」，你可以创建输出到不同目的地的日志器。

1. 控制台日志器（带颜色）

#include <spdlog/spdlog.h> #include <spdlog/sinks/stdout_color_sinks.h> int main() { // 创建多线程安全的控制台日志器（推荐） // mt = multi-thread（多线程安全） auto console_logger = spdlog::stdout_color_mt("my_console_logger"); console_logger->info("你好，控制台日志！"); console_logger->error("出错了，这里是红色！"); // 也可以创建单线程版本（性能更高，但仅限单线程环境用） // auto console_logger_st = spdlog::stdout_color_st("my_console_logger_st"); return 0; }

2. 基础文件日志器（直接写入文件）

#include <spdlog/spdlog.h> #include <spdlog/sinks/basic_file_sink.h> int main() { // 创建多线程安全的文件日志器 // 参数1：日志器名称 // 参数2：日志文件路径 auto file_logger = spdlog::basic_logger_mt("my_file_logger", "./logs/app.log"); file_logger->info("这条日志会写入文件"); file_logger->flush(); // 手动强制刷新（一般不需要，spdlog 会自动处理） return 0; }

3. 轮转文件日志器（按大小 / 日期分割）

常用，可以防止单个日志文件过大。

#include <spdlog/spdlog.h> #include <spdlog/sinks/rotating_file_sink.h> int main() { // 创建轮转文件日志器 // 参数1：日志器名称 // 参数2：基础文件名 // 参数3：单个文件最大大小（示例：5MB） // 参数4：最多保留的文件数量（示例：保留3个旧文件） auto rotating_logger = spdlog::rotating_logger_mt( "my_rotating_logger", "./logs/rotating.log", 1024 * 1024 * 5, // 5MB 3 ); // 测试：写很多日志，触发轮转 for (int i = 0; i < 10000; ++i) { rotating_logger->info("这是第 {} 条轮转测试日志", i); } return 0; }

4. 异步日志器（高性能）

将日志写入交给后台线程，且业务线程不阻塞，适合高并发场景。

#include <spdlog/spdlog.h> #include <spdlog/async.h> #include <spdlog/sinks/basic_file_sink.h> int main() { // 1. 初始化异步线程池（只需初始化一次） // 参数1：队列最大大小 // 参数2：后台线程数量 spdlog::init_thread_pool(8192, 1); // 2. 创建异步文件日志器（注意模板参数 async_factory） auto async_logger = spdlog::basic_logger_mt<spdlog::async_factory>( "my_async_logger", "./logs/async.log" ); async_logger->info("这条日志是后台线程异步写入的"); return 0; }

三、日志级别控制

作用：控制哪些日志能被输出

级别从低到高：

trace < debug < info < warn < error < critical < off

#include <spdlog/spdlog.h> int main() { auto logger = spdlog::stdout_color_mt("level_logger"); // 1. 设置日志级别：只有 >= 该级别的日志才会输出 logger->set_level(spdlog::level::debug); // 设为 debug，debug 及以上都能看到 logger->trace("看不到，因为 trace < debug"); logger->debug("能看到"); logger->info("能看到"); // 2. 也可以设置全局默认日志器的级别 spdlog::set_level(spdlog::level::warn); return 0; }

四、自定义日志格式

spdlog 支持非常灵活的格式自定义，通过占位符实现。

常用占位符

代码示例

#include <spdlog/spdlog.h> int main() { auto logger = spdlog::stdout_color_mt("format_logger"); // 设置自定义格式 // 示例格式：[时间] [日志器名] [级别] 消息 logger->set_pattern("[%Y-%m-%d %H:%M:%S] [%n] [%^%l%$] %v"); // 注：%^ 和 %$ 是颜色范围标记（仅控制台有效） logger->info("这是自定义格式的日志"); return 0; }

五、同时输出到控制台和文件

一个日志器，同时输出到多个地方（比如：开发时控制台看，生产时用文件存）

#include <spdlog/spdlog.h> #include <spdlog/sinks/stdout_color_sinks.h> #include <spdlog/sinks/basic_file_sink.h> #include <vector> int main() { // 1. 创建两个 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_output.log", true); // 2. 把 sink 放进 vector std::vector<spdlog::sink_ptr> sinks {console_sink, file_sink}; // 3. 创建一个自定义 logger，包含这两个 sink auto multi_logger = std::make_shared<spdlog::logger>("multi_logger", sinks.begin(), sinks.end()); // 设置级别和格式（会应用到所有 sink） multi_logger->set_level(spdlog::level::debug); multi_logger->set_pattern("[%H:%M:%S] [%l] %v"); // 注册为全局 logger，之后可以用 spdlog::get 获取 spdlog::register_logger(multi_logger); // 测试：这条日志会同时出现在控制台和文件里 multi_logger->info("这条日志会同时输出到控制台和文件！"); return 0; }

六、其他常用接口

#include <spdlog/spdlog.h> int main() { // 1. 注册与获取全局 logger（跨文件使用很方便） auto my_logger = spdlog::stdout_color_mt("global_logger"); spdlog::register_logger(my_logger); // 注册 // 在其他文件里，通过名字获取 auto logger = spdlog::get("global_logger"); if (logger) { logger->info("通过全局名字获取到了 logger"); } // 2. 设置默认 logger（之后 spdlog::info 就用这个） spdlog::set_default_logger(my_logger); spdlog::info("现在默认用我注册的 logger 了"); // 3. 强制刷新所有 logger spdlog::flush_all(); // 4. 关闭所有 logger（程序退出前可选） spdlog::shutdown(); return 0; }

感谢阅读，本文如有错漏之处，烦请斧正。