使用spdlog可轻松实现高性能日志记录。它是一个C++11头文件-only库,无需编译,支持通过vcpkg或手动集成。包含主头文件后即可用spdlog::info等接口输出日志,默认打印到控制台并支持格式化。可通过basic_logger_mt创建文件日志器,daily_logger_mt实现每日滚动日志,或组合多个sinks实现多目标输出。性能优化关键包括启用异步日志(init_thread_pool)、设置刷新策略(set_flush_on)、定制高效日志格式(set_pattern)及编译期日志级别过滤(SPDLOG_ACTIVE_LEVEL)。最佳实践建议使用try-catch处理异常、复用logger实例、设置默认logger并调用spdlog::shutdown()确保日志完整写入。合理配置下,spdlog能高效支撑高并发场景。

使用spdlog记录高性能日志非常简单,它是一个基于C++11的轻量级、无锁(可选)、高速的日志库,性能远超传统方案。下面介绍如何快速集成和高效使用spdlog。
安装与配置spdlog
spdlog是头文件-only库,无需编译,直接包含即可使用:
- 通过vcpkg或conan等包管理器安装:vcpkg install spdlog
- 手动下载:从GitHub克隆spdlog仓库,将include目录加入项目包含路径
- 在代码中包含主头文件:#include <spdlog/spdlog.h>
基本日志输出
最简单的用法是使用默认日志器:
#include <spdlog/spdlog.h>
int main() {
spdlog::info("程序启动成功");
spdlog::warn("这是一个警告");
spdlog::error("发生错误: {}", "文件未找到");
return 0;
}
默认日志输出到控制台,支持格式化语法(类似Python的format)。
立即学习“C++免费学习笔记(深入)”;
创建自定义日志器
为了更灵活控制输出目标和格式,可以创建专用日志器:
-
文件日志器:记录到文件
<font color="#0066cc"> auto file_logger = spdlog::basic_logger_mt("file_logger", "app.log"); file_logger->info("写入文件日志"); </font> -
每日滚动日志:
<font color="#0066cc"> auto daily_logger = spdlog::daily_logger_mt("daily_logger", "logs/daily.txt", 23, 59); </font> -
多目标日志:同时输出到控制台和文件
<font color="#0066cc"> auto console = spdlog::stdout_color_mt("console"); auto file = spdlog::basic_logger_mt("file", "combined.log"); std::vector<spdlog::sink_ptr> sinks{console, file}; auto combined = std::make_shared<spdlog::logger>("combined", sinks.begin(), sinks.end()); spdlog::register_logger(combined); </font>
提升性能的关键设置
spdlog之所以高性能,关键在于以下配置:
- 启用异步日志:避免主线程阻塞
<font color="#0066cc"> spdlog::init_thread_pool(8192, 1); // 线程池大小和线程数 auto async_file = spdlog::basic_logger_mt<spdlog::async_factory>("async", "async.log"); </font> - 关闭自动刷新(按需开启)
<font color="#0066cc"> spdlog::set_flush_on(spdlog::level::err); // 只有错误时刷新 </font> - 设置高效日志格式
<font color="#0066cc"> spdlog::set_pattern("[%Y-%m-%d %H:%M:%S.%e][%n][%l] %v"); </font> - 编译时定义 SPDLOG_ACTIVE_LEVEL=SPDLOG_LEVEL_INFO 可在编译期过滤低级别日志,减少运行开销
错误处理与最佳实践
spdlog默认会抛出异常,建议包装使用:
- 用try-catch包裹初始化代码,防止文件路径无效等问题
- 使用spdlog::set_default_logger(your_logger)设置全局默认
- 程序退出前调用spdlog::shutdown()确保异步日志写完
- 避免在热路径频繁创建logger,应复用实例










