spdlog 是 C++ 中主流轻量高效日志库，支持多线程、多输出目标、格式化与等级控制，无需 Boost 依赖；支持 header-only 使用，提供控制台、文件、滚动、每日分割等 logger，可自定义格式、级别，具备异步日志与自定义 sink 能力。

在 C++ 项目中做日志记录，spdlog 是目前最主流、轻量又高效的选择。它支持多线程、多种输出目标（控制台、文件、滚动文件）、丰富格式化、等级控制，且无需依赖 Boost 或其他重型库。

快速上手：安装与基础用法

spdlog 是 header-only 库（默认情况下），只需下载头文件即可使用；也可通过包管理器集成：

• CMake + vcpkg：vcpkg install spdlog，然后在 CMakeLists.txt 中 find_package(spdlog)
• Conan：conan install spdlog/1.14.1
• 手动引入：从 GitHub 仓库 下载 include/spdlog 目录，加入编译 include 路径

最简示例（控制台日志）：

#include "spdlog/spdlog.h"

int main() {
    spdlog::info("Hello, {}!", "world");           // INFO 级别
    spdlog::warn("This is a warning");
    spdlog::error("An error occurred: {}", 404);
    return 0;
}

创建不同类型的 logger 实例

全局 logger（如 spdlog::info）方便但不够灵活；实际项目推荐显式创建 logger 对象，便于隔离、复用和配置：

立即学习“C++免费学习笔记（深入）”；

• 控制台 logger：auto console = spdlog::stdout_logger_mt("console");
• 文件 logger：auto file = spdlog::basic_logger_mt("file", "logs/app.log");
• 滚动文件 logger（按大小）：auto rotating = spdlog::rotating_logger_mt("rotating", "logs/rotating.txt", 1048576, 5);（单文件最大 1MB，最多保留 5 个旧文件）
• 每日分割 logger：auto daily = spdlog::daily_logger_mt("daily", "logs/daily.txt", 2, 30);（每天 2:30 自动切分）

自定义格式、级别与线程安全

spdlog 默认格式为 [HH:MM:SS] [level] message，可通过 set_pattern() 修改：

auto logger = spdlog::stdout_logger_mt("my_logger");
logger->set_pattern("[%Y-%m-%d %H:%M:%S.%e] [%n] [%^%l%$] %v"); 
// 输出示例：[2025-05-20 14:22:03.123] [my_logger] [INFO] Hello

日志级别从低到高：trace 。可全局设置最低输出级别：

• spdlog::set_level(spdlog::level::debug);（影响所有 logger）
• logger->set_level(spdlog::level::warn);（仅该 logger）

所有 _mt（multi-thread）版本 logger 内置线程安全，无需额外加锁；若确定单线程环境，可用 _st 版本稍提性能。

进阶技巧：异步日志、自定义 sink 与错误处理

高频写日志时，同步 I/O 可能阻塞主线程。启用异步模式：

auto async_file = spdlog::basic_logger_mt("async", "logs/async.log");
// 注意：程序退出前需调用 spdlog::shutdown() 刷盘

如需输出到网络、数据库或自定义设备，可继承 spdlog::sinks::sink 实现自己的 sink；常见需求已有社区实现（如 spdlog-sinks-kafka）。

错误处理建议：

• 初始化失败时，spdlog 会抛出 spdlog::spdlog_ex 异常，应捕获并 fallback 到 stderr 或静默处理
• 避免在 signal handler（如 SIGSEGV）中直接调用 spdlog，因其内部可能 malloc；可改用 spdlog::default_logger_raw() 的 lock-free 分支（需编译时定义 SPDLOG_COMPILED_LIB 并链接 lib）