gabime/spdlog
开发工具面向 C++ 程序的快速日志库,支持 header-only 或编译使用、多种输出目标、格式化以及同步或异步日志。
项目介绍
spdlog 是一个 C++11 日志库,目标是让 C++ 程序快速、统一地输出日志,而不用自己拼装格式化、线程安全和文件轮转逻辑。它提供 header-only 和编译版两种使用方式,编译版编译更快,README 推荐使用编译版。格式化基于 fmt 库;覆盖同步与异步日志、多线程/单线程 logger、运行时和编译期日志级别、自定义格式,以及多种输出目标(sink):轮转文件、按天切分文件、彩色控制台、syslog、Windows 事件日志、Qt 控件、Android logcat 等。
适合需要成熟日志组件的 C++ 开发者,而不是想要完整应用框架的人。回栈缓冲、多 sink 且每个 sink 独立级别、通过环境变量加载级别、MDC、自定义 sink 等能力都通过头文件和 wiki 文档提供。
快速使用
header-only 方式:把 include/spdlog 目录 复制到构建树中,用 C++11 编译器编译。推荐的编译版方式:
$ git clone https://github.com/gabime/spdlog.git
$ cd spdlog && mkdir build && cd build
$ cmake .. && cmake --build .
示例 CMakeLists.txt 展示了如何链接和使用。也可以使用包管理器,README 列出了 Debian/Ubuntu(libspdlog-dev)、Homebrew、Fedora、Arch、openSUSE、vcpkg、conan、conda 和 build2 的安装命令。
头文件可用后,一个最小程序:
#include "spdlog/spdlog.h"
int main() {
spdlog::info("Welcome to spdlog!");
spdlog::error("Some error message with arg: {}", 1);
spdlog::set_level(spdlog::level::debug);
spdlog::debug("This message should be displayed..");
}
运行后会向默认控制台 logger 输出格式化日志。写文件时使用 sink,例如 spdlog::basic_logger_mt("basic_logger", "logs/basic-log.txt"),或按 README 示例使用轮转文件、按天文件 logger;初始化文件 logger 时建议捕获 spdlog::spdlog_ex,处理无法打开文件的情况。
使用约束
- 需要 C++11 编译器;header-only 方式要引入 include 目录,编译版需要 CMake 构建或使用对应包管理器。
- README 列出的平台:Linux、FreeBSD、OpenBSD、Solaris、AIX;Windows(MSVC 2013+ 或 cygwin);macOS(clang 3.5+);Android。
- 异步日志在创建异步 logger 前需要初始化线程池,例如
spdlog::init_thread_pool(8192, 1);溢出策略block与overrun在负载下行为不同。 - 文档说明 MDC 依赖线程局部存储,因此不支持异步模式。
spdlog::flush_every的周期性 flush 只有在所有 logger 都是线程安全(_mt)版本时才建议使用。- 仓库许可证显示为 NOASSERTION,再分发前需要自行查看许可证文件。
- README 中的 benchmark 是在特定 Ubuntu 机器和 Intel i7-4770 CPU 上测得,不代表其他硬件上的表现。
HotRepo 点评
spdlog 曾进入 HotRepo 的 C++ 日榜:2026-11-17 记录到 29,761 stars、5,339 forks,当日新增 4 星,位列 C++ 日榜第 6。2026 年 8 月的日快照新增分别为 9 和 10 星,近期增长幅度不大但持续。整体约 2.97 万 stars、5.3k forks 说明它是被广泛依赖的基础设施;较低的单日新增更符合一个成熟库的状态,而不是活跃营销的新项目。2014 年的 Hacker News 讨论主要只有一条关于日志库速度差异的提问(评论),没有足够内容用于评价项目本身。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
Hacker News 讨论
相关推荐
- nlohmann/json单头文件 C++11 JSON 库,提供类 STL 语法、序列化、二进制格式与 JSON Patch 支持。
- fmtlib/fmt面向 C++ 开发者的高效类型安全格式化库,可替代 printf 和 iostreams 完成输出与数值格式化。
- simdjson/simdjson用 SIMD 指令把 C++ 的 JSON 解析推到 GB/s 级别的解析库,适合对延迟敏感的高吞吐服务。
- google/guava一套长期存在的 Java 核心库,为 JVM 和 Android 代码提供集合、并发与字符串工具。
- abseil/abseil-cpp一套 C++17 公共库,在标准库之外补充容器、字符串、日志、同步等经生产验证的组件,适合 C++ 开发者直接引用。