spdlog是c++中高性能日志库，支持多线程安全、异步写入与多种输出格式；通过vcpkg、Conan或手动集成引入头文件即可使用；提供默认日志器并支持创建控制台、文件及滚动日志器；可自定义日志级别与格式，启用debug需set_level；异步模式需init_thread_pool提升性能；异常spdlog_ex需try-catch处理。
在C++项目中，日志系统是调试、监控和排查问题的重要工具。spdlog 是一个高性能、易用的开源日志库，基于现代C++（C++11及以上）设计，支持多线程安全、异步日志、多种日志级别和格式化输出，广泛应用于实际开发中。
安装与配置 spdlog
spdlog 是 header-only 的库，意味着你不需要编译它，只需包含头文件即可使用。最简单的集成方式是通过包管理器或直接下载源码。
方法一：使用 vcpkg
vcpkg install spdlog
方法二：使用 Conan
立即学习“C++免费学习笔记（深入）”；
conan install spdlog/1.13.0@
方法三：手动集成
从 gitHub 下载 spdlog 源码：
https://github.com/gabime/spdlog
将 include 目录加入编译路径，在代码中包含即可：
#include <spdlog/spdlog.h>
基本使用方法
spdlog 提供了默认日志器（logger），可以快速开始记录日志。
示例代码：
#include <spdlog/spdlog.h>
int main() {
spdlog::info(“这是一个信息日志”);
spdlog::warn(“这是一个警告日志”);
spdlog::Error(“这是一个错误日志”);
spdlog::debug(“调试信息，可能不会显示”);
return 0;
}
注意：debug 日志在非 DEBUG 模式下默认不输出，需启用：
spdlog::set_level(spdlog::level::debug);
创建自定义日志器
除了默认日志器，你可以创建多个日志器，用于不同模块或输出目标。
控制台日志器
auto console_logger = spdlog::stdout_color_mt(“console”);
console_logger->info(“输出到控制台”);
文件日志器
auto file_logger = spdlog::basic_logger_mt(“file_logger”, “app.log”);
file_logger->info(“这条日志会写入 app.log 文件”);
每日滚动日志
auto daily_logger = spdlog::daily_logger_mt(“daily_logger”, “logs/daily.log”, 2, 30); // 每天凌晨2:30滚动
设置日志格式
spdlog 支持灵活的日志格式设置。可以通过模式字符串定义输出样式。
spdlog::set_pattern(“[%Y-%m-%d %H:%M:%S] [%l] %n: %v”);
常用格式符号：
- %v：日志内容
- %l：日志级别（info、error等）
- ：日志器名称
- %t：线程ID
- %Y/%m/%d %H:%M:%S：时间
也可以为单个日志器设置格式：
console_logger->set_pattern(“[%H:%M:%S] %v”);
异步日志（提升性能）
在高并发场景下，同步写日志可能影响性能。spdlog 支持异步日志，通过后台线程写入。
spdlog::init_thread_pool(8192, 1); // 初始化线程池
auto async_file = spdlog::basic_logger_mt<spdlog::async_logger>(“async_logger”, “async.log”);
async_file->info(“这条日志是异步写入的”);
注意：需链接线程库（如 pthread），并在程序结束前调用：
spdlog::shutdown();
错误处理与运行时检查
spdlog 默认会在日志失败时抛出 spdlog_ex 异常。你可以捕获并处理：
try {
auto logger = spdlog::rotating_logger_mt(“rotate”, “logs/rotating.log”, 1024, 5);
} catch (const spdlog::spdlog_ex &e) {
std::cerr }
也可关闭异常模式，改用静默错误处理：
spdlog::cfg::load_env_levels(); // 可选：从环境变量控制日志级别
基本上就这些。spdlog 使用简单但功能强大，适合大多数C++项目的日志需求。合理使用日志级别、输出目标和格式，能极大提升开发效率和系统可维护性。