搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

gabime/spdlog

开发工具

面向 C++ 程序的快速日志库,支持 header-only 或编译使用、多种输出目标、格式化以及同步或异步日志。

29,770
5,339
C++
NOASSERTION
创建于 12 年前

项目介绍

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 讨论

Spdlog: Super fast C++ logging library
▲ 5 · 1 条评论 · 2014年11月4日

相关推荐

  1. nlohmann/json单头文件 C++11 JSON 库,提供类 STL 语法、序列化、二进制格式与 JSON Patch 支持。C++50,845
  2. fmtlib/fmt面向 C++ 开发者的高效类型安全格式化库,可替代 printf 和 iostreams 完成输出与数值格式化。C++25,911
  3. simdjson/simdjson用 SIMD 指令把 C++ 的 JSON 解析推到 GB/s 级别的解析库,适合对延迟敏感的高吞吐服务。C++24,455
  4. google/guava一套长期存在的 Java 核心库,为 JVM 和 Android 代码提供集合、并发与字符串工具。Java51,914
  5. abseil/abseil-cpp一套 C++17 公共库,在标准库之外补充容器、字符串、日志、同步等经生产验证的组件,适合 C++ 开发者直接引用。C++18,196