如果你在 C 项目里写过日志大概率经历过这样几件事日志格式靠随手拼字符串今天一个风格明天又一个风格想按天切割文件却要自己写文件重命名逻辑程序崩溃之后控制台里的输出早就被冲掉了根本定位不到问题现场。更麻烦的是团队协作时每个人打印日志的粒度完全不同线上排查只能靠“重新加日志再复现一次”这种原始方式。spdlog 能成为 C 日志库里的“事实默认选项”不只是因为它速度快而是因为它把日志这件事的工程边界画得很清楚logger、sink、formatter 各司其职同步和异步切换成本很低既能以头文件方式直接塞进老项目也能通过 CMake 集成到现代工程体系。这篇文章会从工程视角拆解 spdlog 的核心设计、spdlog 下载与接入方式、常用功能、MFC 等桌面程序里的使用注意事项以及真正容易踩的坑。读完你可以直接在一个实际项目里落地它而不是只看懂一个 Hello World。1. 为什么 C 项目需要 spdlog 这样的日志库很多人觉得日志库就是“封装一下 printf”这个想法低估了日志系统的复杂度。一个稍微健壮一点的 C 项目日志需求往往包含这些支持多种输出目标控制台、文件、调试器、远程收集、按大小或日期切割文件、多线程安全、格式化输出、日志级别过滤、异步写入避免阻塞业务线程。如果这些全部自己实现工作量远大于想象。1.1 不用日志库时遇到的问题不用专门日志库时最常见的是直接使用printf或std::cout输出。这种方式在小工具里没问题但进入多线程、长时间运行的服务端程序后问题会逐渐暴露多线程输出会交错日志行被拆得支离破碎。没有日志级别无法在开发、测试、生产环境切换输出粒度。没有文件切割机制单个日志文件越来越大磁盘占比失控。没有统一格式化时间戳、线程号、日志级别这些信息要么没有要么每次手写。写文件用fprintf加手动fflush性能差且容易丢日志。这些问题的本质是日志不是一个“顺手写两行”的功能而是一个横跨 IO、并发、运维的工程模块。与其让每个开发人员自己造轮子不如用社区验证过的库把精力放在业务逻辑上。1.2 spdlog 的核心价值spdlog 的价值可以浓缩成三个词快、简单、可扩展。快它提供了高性能的异步日志模式通过预格式化、批量写入、无锁或低锁队列等手段减少日志对业务线程的影响。在大量日志输出场景下异步模式能明显降低写日志带来的延迟。简单API 设计非常接近开发者直觉。spdlog::info(Hello {}, name)一行就能输出到控制台想输出到文件就换一个basic_logger_mt想异步就在创建 logger 时换一个工厂函数。可扩展sink 机制把“输出到哪”完全抽象出来。官方提供了控制台、文件、滚动文件、每日文件、syslog、MSVC 调试器等 sink你也可以继承 base_sink 实现自定义输出比如上报到监控系统或写入数据库。对于中小型 C 项目spdlog 几乎是性价比最高的选择对于大型项目它也足够作为日志底座配合监控平台做二次开发。2. spdlog 核心概念与设计原理在写代码之前先理解 spdlog 的三个核心对象logger、sink、formatter。这三者的关系很像一个内容生产团队的协作流程logger 是记者负责采集和发起一条日志sink 是发布渠道决定这条日志出现在报纸、网站还是电视上formatter 是编辑决定最终呈现的排版样式。2.1 logger 与 sink 的职责划分logger 是开发者直接使用的入口它负责接收日志内容、判断当前日志级别是否允许输出然后把消息交给一个或多个 sink。一个 logger 可以绑定多个 sink例如同时输出到控制台和文件。sink 负责真正的输出动作。它不关心日志内容长什么样只关心把消息送到哪里。官方常用 sink包括sink 类型输出目标典型应用场景stdout_sink标准输出控制台程序调试stderr_sink标准错误输出错误信息单独输出basic_file_sink单个文件简单文件日志rotating_file_sink按大小切割的文件日志文件大小控制daily_file_sink按日期切割的文件长时间运行的服务器msvc_sinkVisual Studio 调试器Windows 桌面程序调试syslog_sinksyslogLinux 服务程序这种职责划分带来的好处是业务代码只面向 logger 编程替换输出目标时不需要改动业务逻辑。比如开发时用控制台输出的 logger部署时切换成异步滚动文件 logger业务代码保持不变。2.2 日志级别spdlog 的日志级别从低到高依次是trace、debug、info、warn、err、critical、off。在实际项目中建议至少区分两个层级的控制编译期级别和运行期级别。编译期级别通过宏SPDLOG_ACTIVE_LEVEL控制。所有低于该级别的日志调用在编译时会被直接剔除不产生任何运行时代价。发布版本通常会设成SPDLOG_LEVEL_INFO或SPDLOG_LEVEL_WARN把 trace 和 debug 日志完全过滤掉。运行期级别通过logger-set_level()或全局spdlog::set_level()控制用于在运行中动态调整日志输出粒度排查问题时临时打开 debug 日志非常有用。默认情况下spdlog::info这样的全局函数使用的是名为空字符串字符串的默认 logger它的级别是 info。如果需要更精细的控制建议使用命名 logger。2.3 同步与异步spdlog 支持两种日志模式同步模式日志调用直接在当前线程完成格式化并写入目标。优点是实现简单、日志实时可见缺点是写文件、输出控制台等 IO 操作可能阻塞业务线程。异步模式日志调用先进入一个线程池队列由后台线程统一取出并写入。业务线程只负责入队耗时极短适合高频日志场景。代价是日志写入有轻微延迟极端情况下队列满或线程池繁忙时可能丢日志。选择依据很简单如果日志量不大同步模式就够了如果日志量大或者业务线程对延迟敏感就使用异步模式。不要把“必须异步”作为唯一标准异步会带来丢日志风险也需要额外调试线程池配置。2.4 头文件库与编译方式spdlog 默认是 header-only 库直接包含头文件即可使用。它的格式化底层依赖 fmt 库spdlog 内部已经处理了与外部 fmt 的兼容问题。按源码方式接入时不需要额外下载 fmtspdlog 会使用内置的 fmt 实现。如果项目对编译时间敏感也可以使用SPDLOG_COMPILED_LIB宏将 spdlog 编译成静态库减少多次包含头文件带来的编译开销。不过对大多数中小项目来说header-only 方式已经足够简单直接。3. 环境准备与 spdlog 下载集成方式3.1 环境要求spdlog 对运行环境的要求并不高这一点对老项目特别友好。完整的依赖信息应以官方 README 为准这里给出通用的参考编译器支持 C11 或更高建议使用 C14 或 C17。CMake推荐 3.14 以上使用 FetchContent 集成要求 CMake 版本更高。操作系统Windows、Linux、macOS 均可。构建工具Visual Studio、GCC、Clang 均有官方支持。3.2 spdlog 下载与源码获取spdlog 的下载方式很多项目没有统一要求根据你的项目类型选择即可。方式一直接下载源码最常见的方式是访问 GitHub 上 gabime/spdlog 仓库的 Releases 页面下载最新版本的源码压缩包解压后把 include 目录添加到项目的头文件路径中。这种方式适合不使用包管理器的老项目。方式二vcpkgWindows 下使用 vcpkg 安装非常简单vcpkg install spdlog安装后通过 CMake 的find_package(spdlog REQUIRED)引入适合 Visual Studio 项目或 CMake 项目。方式三Conan使用 Conan 的项目可以通过配置依赖引入conan install spdlog/1.14.1具体版本号需要根据仓库可用版本调整建议以 Conan Center 为准。方式四CMake FetchContent这是现代 CMake 项目最推荐的集成方式直接写在CMakeLists.txt中cmake_minimum_required(VERSION 3.14) project(SpdlogDemo) set(CMAKE_CXX_STANDARD 17) include(FetchContent) FetchContent_Declare( spdlog GIT_REPOSITORY https://github.com/gabime/spdlog GIT_TAG v1.14.1 ) FetchContent_MakeAvailable(spdlog) add_executable(demo main.cpp) target_link_libraries(demo PRIVATE spdlog::spdlog)这里把GIT_TAG写成示例版本号实际使用时请到 GitHub Releases 页面查看最新稳定 tag 并替换。FetchContent 方式的好处是依赖版本明确团队其他人拉取代码后不需要手动安装任何东西CMake 会自动下载并构建。3.3 老项目手动集成如果你维护的是一个没有 CMake 的老项目最简单的做法就是“源码拷贝 include 目录”。下载 spdlog 源码后只需要让编译器能找到 include 目录然后把spdlog这个头文件目录复制到项目的 third_party 下即可。这种方式下头文件库的所有代码在第一个包含点完成实例化不需要单独编译链接。4. 第一个 spdlog 示例从控制台到文件4.1 最小控制台示例先写一个最简单的程序验证 spdlog 是否正常工作。这个程序会使用全局默认 logger 输出三条不同级别的日志。// 文件路径main.cpp #include spdlog/spdlog.h int main() { spdlog::info(Hello, {}!, spdlog); spdlog::warn(trying to connect to {}:{}, 127.0.0.1, 8080); spdlog::error(failed to open file {}, config.ini); return 0; }编译运行后终端会输出类似下面的结果[2024-06-01 12:00:00.123] [info] Hello, spdlog! [2024-06-01 12:00:00.123] [warning] trying to connect to 127.0.0.1:8080 [2024-06-01 12:00:00.123] [error] failed to open file config.ini这里需要注意spdlog::info的格式化语法是花括号占位符而不是 printf 的百分号占位符。{}会自动调用类型的operator或 spdlog 内置的格式化规则相比 printf 更安全不会因为类型不匹配导致未定义行为。4.2 输出到文件控制台输出通常只适合开发调试生产环境需要把日志写入文件。spdlog 提供了basic_logger_mt创建一个写单个简单文件的 logger。// 文件路径file_log.cpp #include spdlog/spdlog.h #include spdlog/sinks/basic_file_sink.h int main() { // 创建一个名为 file_logger 的 logger输出到 logs/app.log auto logger spdlog::basic_logger_mt(file_logger, logs/app.log); logger-info(application started); logger-warn(memory usage is high: {} MB, 1280); logger-error(database connection failed: {}, 10053); return 0; }注意两个细节basic_logger_mt中的_mt表示 multi-thread即线程安全版本。对于多线程程序默认使用_mt系列如果你的程序明确是单线程可以使用_st系列减少一点锁开销。如果logs目录不存在程序会报错。spdlog 不会自动创建多级目录需要自己确保路径存在。编译时需要把spdlog/sinks/basic_file_sink.h一起包含因为创建文件 logger 的工厂函数定义在这个头文件中。不同 sink 对应的头文件需要单独引入这也是新手容易忽略的一点。4.3 如何验证是否成功运行上面的程序后检查两点程序退出时没有异常输出。logs/app.log文件存在且内容包含三条日志。如果文件不存在先确认程序是否真的执行到了创建 logger 的代码。spdlog 在创建文件 sink 时会尝试打开文件如果失败会抛出异常默认情况下异常会传播到main导致程序终止。注意在真实项目中尤其是服务端程序建议对 logger 创建过程做异常捕获避免日志系统故障影响主业务流程。5. 常用功能实践格式化、滚动文件、多 logger5.1 自定义日志格式spdlog 默认的日志格式已经包含时间、级别和消息但实际项目中往往需要更多信息比如线程号、logger 名称、源码文件名和行号。这些可以通过set_pattern设置。#include spdlog/spdlog.h int main() { spdlog::set_pattern([%Y-%m-%d %H:%M:%S.%e] [%^%l%$] [thread %t] %v); spdlog::info(this is a custom pattern log); return 0; }常用 pattern 占位符如下占位符含义%Y-%m-%d %H:%M:%S日期和时间%e毫秒部分%l日志级别%^ 和 %$设置和恢复日志级别颜色%t线程号%nlogger 名称%s源文件名%#源文件行号%v日志消息内容实际项目中我建议至少在 pattern 中包含时间、级别、线程号和消息内容。分布式系统还可以把 trace id 或 request id 放在消息中方便链路追踪。5.2 滚动文件日志生产环境最常见的是限制单个日志文件大小超过后自动切换文件并保留最近的 N 份历史日志。spdlog 用rotating_logger_mt实现#include spdlog/spdlog.h #include spdlog/sinks/rotating_file_sink.h int main() { // 单个文件最大 5MB最多保留 3 个文件 auto logger spdlog::rotating_logger_mt( rotating_logger, logs/rotate.log, 1024 * 1024 * 5, 3 ); for (int i 0; i 10000; i) { logger-info(log message {}, i); } return 0; }当rotate.log达到 5MB 时spdlog 会把它重命名为rotate.1.log旧的rotate.1.log变成rotate.2.log最多保留 3 个文件。这个机制能防止日志无限增长占满磁盘。5.3 每日文件日志服务器程序更适合按日期拆分日志每天一个文件便于后续归档和检索。#include spdlog/spdlog.h #include spdlog/sinks/daily_file_sink.h int main() { // 每天 0 点 0 分创建新文件 auto logger spdlog::daily_logger_mt(daily_logger, logs/daily.log, 0, 0); logger-info(todays log); return 0; }daily_logger_mt的第一个时间参数是小时第二个是分钟。它会在当前日期变化且达到设定时间后自动生成带日期后缀的新日志文件。5.4 多 logger 与日志分离在复杂项目中不同模块的日志往往需要分开管理。比如业务日志、系统日志、SQL 日志分别输出到不同目录。spdlog 支持创建多个命名 logger并通过spdlog::get在任意位置获取。// 多 logger 示例 #include spdlog/spdlog.h #include spdlog/sinks/basic_file_sink.h #include spdlog/sinks/stdout_color_sinks.h int main() { // 控制台 logger auto console spdlog::stdout_color_mt(console); // 业务日志文件 logger auto business spdlog::basic_logger_mt(business, logs/business.log); // 在其他代码位置通过名字获取已有 logger auto logger spdlog::get(business); if (logger) { logger-info(business event occurred); } spdlog::get(console)-info(console message); return 0; }这里有几个工程要点stdout_color_mt是带颜色的控制台 logger在 Visual Studio 调试器中也有较好体验。每个 logger 默认继承全局 level但可以单独调用set_level覆盖。spdlog::get返回std::shared_ptrspdlog::logger如果 logger 不存在会返回空指针使用前建议判空或者在程序初始化阶段统一创建并持有不要频繁在业务代码里按名字查找。5.5 自定义 sink当官方 sink 无法满足需求时继承sinks::base_sink实现一个自定义 sink 并不难。比如需要把日志写入消息队列或监控平台时可以重写sink_it_方法。典型结构如下#include spdlog/sinks/base_sink.h template typename Mutex class my_sink final : public spdlog::sinks::base_sinkMutex { protected: void sink_it_(const spdlog::details::log_msg msg) override { // 在这里处理 msg比如发送到远程收集服务 spdlog::memory_buf_t formatted; this-formatter_-format(msg, formatted); // 将 formatted 发送到远端 } void flush_() override { // 处理 flush 逻辑 } };自定义 sink 的复杂度适中但要注意线程安全性。如果 sink 内部需要访问共享资源应该使用_mt对应的互斥锁模板或自行加锁。6. 异步日志模式实践6.1 为什么需要异步日志服务端程序如果采用同步日志每次写日志都会产生一次文件 IO。在高 QPS 场景下日志写入的耗时可能累积到几十毫秒甚至更多直接影响接口响应时间。异步日志的核心思路是业务线程只把日志消息丢进内存队列后台线程池负责批量写入文件业务线程不会被 IO 阻塞。6.2 异步 logger 创建方式spdlog 提供了spdlog::init_thread_pool和create_async系列函数来创建异步 logger。// 异步日志示例 #include spdlog/spdlog.h #include spdlog/async.h #include spdlog/sinks/basic_file_sink.h int main() { // 初始化线程池队列大小 8192后台线程数 1 spdlog::init_thread_pool(8192, 1); // 创建异步文件 logger auto async_logger spdlog::create_asyncspdlog::sinks::basic_file_sink_mt( async_file_logger, logs/async.log ); for (int i 0; i 1000; i) { async_logger-info(async message {}, i); } // 退出前确保所有日志写完 spdlog::shutdown(); return 0; }这里有两个容易出错的细节。第一个是init_thread_pool的调用时机。它必须在使用任何异步 logger 之前执行否则 spdlog 会使用默认参数创建的线程池。默认线程池通常也够用但明确设置队列大小和线程数更可控。第二个是spdlog::shutdown()。异步模式下日志先进入内存队列由后台线程消费。如果程序直接退出队列中尚未写入文件的日志会丢失。调用shutdown()会等待后台线程完成当前队列的写入这是异步日志可靠性的关键一步。6.3 有界队列与丢弃策略create_async当队列满时新的日志消息会阻塞等待队列有空位这虽然保证了不丢日志但可能会让业务线程等待。如果希望在队列满时直接丢弃日志可以使用create_async_nb系列其中nb表示 non-blocking。#include spdlog/spdlog.h #include spdlog/async.h #include spdlog/sinks/stdout_color_sinks.h int main() { spdlog::init_thread_pool(1024, 1); // 非阻塞异步 logger队列满时丢弃新日志 auto logger spdlog::create_async_nbspdlog::sinks::stdout_color_sink_mt(async_nb); logger-info(message 1); logger-info(message 2); spdlog::shutdown(); return 0; }非阻塞模式更适合日志量巨大、且不允许业务线程等待的场景但要接受“极端情况下丢日志”的代价。从告警统计角度丢少量日志通常可以接受从审计角度这可能是不可接受的。6.4 flush 策略flush 是另一个需要关注的细节。默认情况下spdlog 会在以下时机触发 flush调用logger-flush()或spdlog::flush_all()。使用spdlog::flush_on(spdlog::level::warn)设置达到某个级别时自动 flush。使用spdlog::flush_every(std::chrono::seconds(3))设置每隔一段时间自动 flush 所有 logger。服务端程序通常建议设置flush_on(level::warn)保证 warn 及更严重的日志立即落盘而普通 info 日志按周期批量写入。这样兼顾性能和可靠性。7. MFC / Windows 桌面程序使用 spdlog 的注意事项Windows 桌面开发中MFC 项目接入 spdlog 很常见但有一些坑和典型控制台程序不一样。7.1 头文件路径与项目配置MFC 项目往往没有 CMake 或者使用的构建系统比较老。最简单的方式是下载 spdlog 源码把 include 目录配置到项目属性页的“C/C - 常规 - 附加包含目录”。如果使用 Visual Studio 的 vcpkg可以用 vcpkg 安装后通过#include spdlog/spdlog.h直接使用前提是项目开启了 MSBuild 的 vcpkg 集成。需要注意一点spdlog 默认使用 UTF-8 编码的字符串。MFC 项目通常默认使用 Unicode 字符集CString是CStringW。直接把CString传给 spdlog 的{}占位符并不会得到预期的可读内容需要先转成 UTF-8 的std::string。7.2 CString 转 UTF-8 示例// 在 MFC 项目中封装一个转换函数 #include spdlog/spdlog.h #include atlstr.h std::string CStringToUtf8(const CString str) { if (str.IsEmpty()) { return ; } int length WideCharToMultiByte( CP_UTF8, 0, str.GetString(), -1, nullptr, 0, nullptr, nullptr ); std::string result(length - 1, \0); WideCharToMultiByte( CP_UTF8, 0, str.GetString(), -1, result.data(), length, nullptr, nullptr ); return result; } void LogMfcMessage(const CString message) { spdlog::info([MFC] {}, CStringToUtf8(message)); }上面的代码使用WideCharToMultiByte将宽字符CString转换为 UTF-8 编码的std::string再交给 spdlog 输出。如果你在控制台或日志文件里看到中文乱码大概率就是没有做这一步编码转换。7.3 使用 MSVC 调试器输出在 Visual Studio 里调试 MFC 程序时可以在 Output 窗口直接看到日志这得益于 spdlog 的 msvc_sink。#include spdlog/spdlog.h #include spdlog/sinks/msvc_sink.h void InitDebugLogger() { auto msvc_logger spdlog::msvc_logger_mt(msvc); msvc_logger-set_level(spdlog::level::debug); msvc_logger-info(output to Visual Studio debug window); }msvc_sink 会把日志调用转换为OutputDebugStringA输出调试时非常方便生产环境则不应该使用它作为唯一输出。7.4 UI 线程与异步日志MFC 程序的主线程是 UI 线程如果在 UI 消息响应里直接写同步文件日志用户会感觉到界面卡顿。尤其是按钮点击、定时器回调这些高频场景日志量稍大就会拖慢消息循环。稳妥的做法是把 spdlog 初始化为异步 logger业务线程通过队列把日志交给后台线程UI 线程只做入队操作不会因为磁盘 IO 变慢。7.5 运行时库配置MFC 项目的 C/C 运行时库可能配置为多线程调试 /MTd、多线程 /MT、多线程 DLL /MD 等。如果 spdlog 是 header-only 方式使用它与你项目使用同一套运行时库问题不大。如果使用了 spdlog 的编译库版本则必须保证 spdlog 库和你的项目采用相同的运行时库配置否则会出现链接错误或运行时不匹配的问题。稳妥起见使用 header-only 方式接入 MFC 项目最省事。8. spdlog 常见问题与排查方法下面是接入 spdlog 时最常遇到的几类问题整理成排查表方便直接对照。问题现象可能原因排查方式解决方案编译报错找不到 spdlog.hinclude 目录未配置检查编译命令或项目属性页的附加包含目录下载 spdlog 后把 include 目录加入编译路径链接错误符号重定义或找不到符号使用了 SPDLOG_COMPILED_LIB 但未统一宏定义查看所有使用 spdlog 的文件是否包含相同宏统一要么全部 header-only要么全部定义 SPDLOG_COMPILED_LIB控制台输出乱码源文件编码与日志输出端编码不一致检查源码文件编码和终端代码页统一使用 UTF-8或在 Windows 使用 /utf-8 编译选项文件日志没有生成目录不存在或路径错误检查日志目录是否存在确认程序没有抛出异常创建目录或添加异常捕获查看错误信息异步模式退出时丢失日志没有调用 shutdown检查程序退出流程在 main 结束前调用 spdlog::shutdown()日志文件不断增长切割不生效rotating 参数设置不合理或文件被占用检查是否有进程持有日志文件句柄调低单文件大小上限或避免外部程序占用文件多线程日志顺序乱不同线程打印顺序确实无法严格保证确认是线程安全问题还是业务预期问题给日志加序号或时间戳按时间排序FetchContent 拉取 spdlog 缓慢网络问题或 GitHub 访问不稳定检查 CMake 下载输出改用源码拷贝或 vcpkg/Conan或使用镜像编译耗时明显增加头文件库导致每个翻译单元都解析 spdlog观察编译耗时使用预编译头或改为 SPDLOG_COMPILED_LIB 编译库方式MFC 中 CString 输出乱码宽字符未转 UTF-8打断点查看转换结果使用 WideCharToMultiByte 转换为 UTF-8排查 spdlog 问题时一个通用思路是先确认是编译期问题还是运行期问题然后分模块缩小范围。编译期问题优先看宏定义和头文件路径运行期问题优先看 logger 创建时的返回值、异常信息和目标目录权限。9. 工程最佳实践与生产环境建议9.1 封装自己的日志接口虽然 spdlog 的 API 已经很好用但建议在业务代码里再包一层薄封装而不是直接到处调用spdlog::info。原因是业务代码不应该依赖具体日志库实现未来如果切换到其他日志系统只需要改封装层。封装时保留 spdlog 的格式化能力同时统一传入模块名、业务关键词等上下文。// 简单封装示例 #pragma once #include spdlog/spdlog.h #include string namespace applog { void Init(bool async, const std::string log_dir); void Info(const std::string msg); void Warn(const std::string msg); void Error(const std::string msg); }当然封装也不要过度设计。小型项目直接使用 spdlog 的全局 logger 也非常合理关键是项目里要有统一的习惯。9.2 合理设置日志级别建议遵循以下原则开发环境默认输出 debug 或 trace方便排查。测试环境默认输出 info。生产环境默认输出 info 或 warn避免大量 debug 日志压垮磁盘。线上临时排查时通过配置中心或环境变量动态调整某模块的日志级别不建议修改代码后重新发布。可以用环境变量在启动时初始化日志级别例如读取MYAPP_LOG_LEVEL这样运维可以不改代码调整级别。9.3 日志文件管理生产环境建议至少做到使用 rotating 或 daily 日志设置大小上限和保留份数。日志目录单独规划不要和程序目录混在一起。定期检查磁盘占用设置日志文件老化删除策略。如果按天切分文件名中包含日期例如app-2024-06-01.log。9.4 性能优化注意点避免在日志消息里拼接大字符串尤其是循环中的高频日志。先判断该 level 是否开启再构造消息。使用SPDLOG_ACTIVE_LEVEL在编译期关闭低级别日志。异步模式下合理设置队列大小过小会丢日志过大占用内存。不要在日志格式中使用过于复杂的自定义格式化器每次日志输出都会执行一次格式化。9.5 安全与合规提醒日志中不要记录密码、密钥、token、身份证号、银行卡号等敏感信息。如果你确实需要记录请求参数用于排查对敏感字段做脱敏处理例如只保留前后几位。这类问题在日志系统上线后很容易被忽略等出了安全事故再整改代价很大。9.6 异常处理与降级日志系统本身也可能出问题比如磁盘满、目录权限错误、队列异常。生产环境建议对日志初始化做异常捕获避免日志库故障导致业务进程启动失败。极端情况下日志写入失败应该降级而不是阻塞业务这和使用异步非阻塞模式的选择是相关的。10. 总结与后续学习方向spdlog 之所以被广泛使用核心原因不是某个单点功能多么惊艳而是它把 C 项目日志系统的复杂度控制在了合理的范围内。logger 负责业务侧sink 负责输出侧formatter 负责展示侧异步线程池解决性能问题滚动和每日切割解决运维问题。理解这些概念后再去看它的源码会清晰很多。下一步建议做三件事第一用本文的示例在自己项目里跑通控制台日志和文件日志第二根据项目特点选择同步还是异步、rolling 还是 daily把日志级别和 flush 策略配置好第三如果对内部实现感兴趣可以按logger - sink - formatter - thread_pool的调用链读源码重点看异步队列和批量刷盘的实现。落地 spdlog 并不难但真正让日志系统在团队里发挥作用靠的是统一规范、合理配置和持续迭代。建议把这篇文章收藏备用在接入 spdlog 时对照检查能少踩很多不必要的坑。 spdlog实战：C++日志库的工程化接入与性能优化
如果你在 C 项目里写过日志大概率经历过这样几件事日志格式靠随手拼字符串今天一个风格明天又一个风格想按天切割文件却要自己写文件重命名逻辑程序崩溃之后控制台里的输出早就被冲掉了根本定位不到问题现场。更麻烦的是团队协作时每个人打印日志的粒度完全不同线上排查只能靠“重新加日志再复现一次”这种原始方式。spdlog 能成为 C 日志库里的“事实默认选项”不只是因为它速度快而是因为它把日志这件事的工程边界画得很清楚logger、sink、formatter 各司其职同步和异步切换成本很低既能以头文件方式直接塞进老项目也能通过 CMake 集成到现代工程体系。这篇文章会从工程视角拆解 spdlog 的核心设计、spdlog 下载与接入方式、常用功能、MFC 等桌面程序里的使用注意事项以及真正容易踩的坑。读完你可以直接在一个实际项目里落地它而不是只看懂一个 Hello World。1. 为什么 C 项目需要 spdlog 这样的日志库很多人觉得日志库就是“封装一下 printf”这个想法低估了日志系统的复杂度。一个稍微健壮一点的 C 项目日志需求往往包含这些支持多种输出目标控制台、文件、调试器、远程收集、按大小或日期切割文件、多线程安全、格式化输出、日志级别过滤、异步写入避免阻塞业务线程。如果这些全部自己实现工作量远大于想象。1.1 不用日志库时遇到的问题不用专门日志库时最常见的是直接使用printf或std::cout输出。这种方式在小工具里没问题但进入多线程、长时间运行的服务端程序后问题会逐渐暴露多线程输出会交错日志行被拆得支离破碎。没有日志级别无法在开发、测试、生产环境切换输出粒度。没有文件切割机制单个日志文件越来越大磁盘占比失控。没有统一格式化时间戳、线程号、日志级别这些信息要么没有要么每次手写。写文件用fprintf加手动fflush性能差且容易丢日志。这些问题的本质是日志不是一个“顺手写两行”的功能而是一个横跨 IO、并发、运维的工程模块。与其让每个开发人员自己造轮子不如用社区验证过的库把精力放在业务逻辑上。1.2 spdlog 的核心价值spdlog 的价值可以浓缩成三个词快、简单、可扩展。快它提供了高性能的异步日志模式通过预格式化、批量写入、无锁或低锁队列等手段减少日志对业务线程的影响。在大量日志输出场景下异步模式能明显降低写日志带来的延迟。简单API 设计非常接近开发者直觉。spdlog::info(Hello {}, name)一行就能输出到控制台想输出到文件就换一个basic_logger_mt想异步就在创建 logger 时换一个工厂函数。可扩展sink 机制把“输出到哪”完全抽象出来。官方提供了控制台、文件、滚动文件、每日文件、syslog、MSVC 调试器等 sink你也可以继承 base_sink 实现自定义输出比如上报到监控系统或写入数据库。对于中小型 C 项目spdlog 几乎是性价比最高的选择对于大型项目它也足够作为日志底座配合监控平台做二次开发。2. spdlog 核心概念与设计原理在写代码之前先理解 spdlog 的三个核心对象logger、sink、formatter。这三者的关系很像一个内容生产团队的协作流程logger 是记者负责采集和发起一条日志sink 是发布渠道决定这条日志出现在报纸、网站还是电视上formatter 是编辑决定最终呈现的排版样式。2.1 logger 与 sink 的职责划分logger 是开发者直接使用的入口它负责接收日志内容、判断当前日志级别是否允许输出然后把消息交给一个或多个 sink。一个 logger 可以绑定多个 sink例如同时输出到控制台和文件。sink 负责真正的输出动作。它不关心日志内容长什么样只关心把消息送到哪里。官方常用 sink包括sink 类型输出目标典型应用场景stdout_sink标准输出控制台程序调试stderr_sink标准错误输出错误信息单独输出basic_file_sink单个文件简单文件日志rotating_file_sink按大小切割的文件日志文件大小控制daily_file_sink按日期切割的文件长时间运行的服务器msvc_sinkVisual Studio 调试器Windows 桌面程序调试syslog_sinksyslogLinux 服务程序这种职责划分带来的好处是业务代码只面向 logger 编程替换输出目标时不需要改动业务逻辑。比如开发时用控制台输出的 logger部署时切换成异步滚动文件 logger业务代码保持不变。2.2 日志级别spdlog 的日志级别从低到高依次是trace、debug、info、warn、err、critical、off。在实际项目中建议至少区分两个层级的控制编译期级别和运行期级别。编译期级别通过宏SPDLOG_ACTIVE_LEVEL控制。所有低于该级别的日志调用在编译时会被直接剔除不产生任何运行时代价。发布版本通常会设成SPDLOG_LEVEL_INFO或SPDLOG_LEVEL_WARN把 trace 和 debug 日志完全过滤掉。运行期级别通过logger-set_level()或全局spdlog::set_level()控制用于在运行中动态调整日志输出粒度排查问题时临时打开 debug 日志非常有用。默认情况下spdlog::info这样的全局函数使用的是名为空字符串字符串的默认 logger它的级别是 info。如果需要更精细的控制建议使用命名 logger。2.3 同步与异步spdlog 支持两种日志模式同步模式日志调用直接在当前线程完成格式化并写入目标。优点是实现简单、日志实时可见缺点是写文件、输出控制台等 IO 操作可能阻塞业务线程。异步模式日志调用先进入一个线程池队列由后台线程统一取出并写入。业务线程只负责入队耗时极短适合高频日志场景。代价是日志写入有轻微延迟极端情况下队列满或线程池繁忙时可能丢日志。选择依据很简单如果日志量不大同步模式就够了如果日志量大或者业务线程对延迟敏感就使用异步模式。不要把“必须异步”作为唯一标准异步会带来丢日志风险也需要额外调试线程池配置。2.4 头文件库与编译方式spdlog 默认是 header-only 库直接包含头文件即可使用。它的格式化底层依赖 fmt 库spdlog 内部已经处理了与外部 fmt 的兼容问题。按源码方式接入时不需要额外下载 fmtspdlog 会使用内置的 fmt 实现。如果项目对编译时间敏感也可以使用SPDLOG_COMPILED_LIB宏将 spdlog 编译成静态库减少多次包含头文件带来的编译开销。不过对大多数中小项目来说header-only 方式已经足够简单直接。3. 环境准备与 spdlog 下载集成方式3.1 环境要求spdlog 对运行环境的要求并不高这一点对老项目特别友好。完整的依赖信息应以官方 README 为准这里给出通用的参考编译器支持 C11 或更高建议使用 C14 或 C17。CMake推荐 3.14 以上使用 FetchContent 集成要求 CMake 版本更高。操作系统Windows、Linux、macOS 均可。构建工具Visual Studio、GCC、Clang 均有官方支持。3.2 spdlog 下载与源码获取spdlog 的下载方式很多项目没有统一要求根据你的项目类型选择即可。方式一直接下载源码最常见的方式是访问 GitHub 上 gabime/spdlog 仓库的 Releases 页面下载最新版本的源码压缩包解压后把 include 目录添加到项目的头文件路径中。这种方式适合不使用包管理器的老项目。方式二vcpkgWindows 下使用 vcpkg 安装非常简单vcpkg install spdlog安装后通过 CMake 的find_package(spdlog REQUIRED)引入适合 Visual Studio 项目或 CMake 项目。方式三Conan使用 Conan 的项目可以通过配置依赖引入conan install spdlog/1.14.1具体版本号需要根据仓库可用版本调整建议以 Conan Center 为准。方式四CMake FetchContent这是现代 CMake 项目最推荐的集成方式直接写在CMakeLists.txt中cmake_minimum_required(VERSION 3.14) project(SpdlogDemo) set(CMAKE_CXX_STANDARD 17) include(FetchContent) FetchContent_Declare( spdlog GIT_REPOSITORY https://github.com/gabime/spdlog GIT_TAG v1.14.1 ) FetchContent_MakeAvailable(spdlog) add_executable(demo main.cpp) target_link_libraries(demo PRIVATE spdlog::spdlog)这里把GIT_TAG写成示例版本号实际使用时请到 GitHub Releases 页面查看最新稳定 tag 并替换。FetchContent 方式的好处是依赖版本明确团队其他人拉取代码后不需要手动安装任何东西CMake 会自动下载并构建。3.3 老项目手动集成如果你维护的是一个没有 CMake 的老项目最简单的做法就是“源码拷贝 include 目录”。下载 spdlog 源码后只需要让编译器能找到 include 目录然后把spdlog这个头文件目录复制到项目的 third_party 下即可。这种方式下头文件库的所有代码在第一个包含点完成实例化不需要单独编译链接。4. 第一个 spdlog 示例从控制台到文件4.1 最小控制台示例先写一个最简单的程序验证 spdlog 是否正常工作。这个程序会使用全局默认 logger 输出三条不同级别的日志。// 文件路径main.cpp #include spdlog/spdlog.h int main() { spdlog::info(Hello, {}!, spdlog); spdlog::warn(trying to connect to {}:{}, 127.0.0.1, 8080); spdlog::error(failed to open file {}, config.ini); return 0; }编译运行后终端会输出类似下面的结果[2024-06-01 12:00:00.123] [info] Hello, spdlog! [2024-06-01 12:00:00.123] [warning] trying to connect to 127.0.0.1:8080 [2024-06-01 12:00:00.123] [error] failed to open file config.ini这里需要注意spdlog::info的格式化语法是花括号占位符而不是 printf 的百分号占位符。{}会自动调用类型的operator或 spdlog 内置的格式化规则相比 printf 更安全不会因为类型不匹配导致未定义行为。4.2 输出到文件控制台输出通常只适合开发调试生产环境需要把日志写入文件。spdlog 提供了basic_logger_mt创建一个写单个简单文件的 logger。// 文件路径file_log.cpp #include spdlog/spdlog.h #include spdlog/sinks/basic_file_sink.h int main() { // 创建一个名为 file_logger 的 logger输出到 logs/app.log auto logger spdlog::basic_logger_mt(file_logger, logs/app.log); logger-info(application started); logger-warn(memory usage is high: {} MB, 1280); logger-error(database connection failed: {}, 10053); return 0; }注意两个细节basic_logger_mt中的_mt表示 multi-thread即线程安全版本。对于多线程程序默认使用_mt系列如果你的程序明确是单线程可以使用_st系列减少一点锁开销。如果logs目录不存在程序会报错。spdlog 不会自动创建多级目录需要自己确保路径存在。编译时需要把spdlog/sinks/basic_file_sink.h一起包含因为创建文件 logger 的工厂函数定义在这个头文件中。不同 sink 对应的头文件需要单独引入这也是新手容易忽略的一点。4.3 如何验证是否成功运行上面的程序后检查两点程序退出时没有异常输出。logs/app.log文件存在且内容包含三条日志。如果文件不存在先确认程序是否真的执行到了创建 logger 的代码。spdlog 在创建文件 sink 时会尝试打开文件如果失败会抛出异常默认情况下异常会传播到main导致程序终止。注意在真实项目中尤其是服务端程序建议对 logger 创建过程做异常捕获避免日志系统故障影响主业务流程。5. 常用功能实践格式化、滚动文件、多 logger5.1 自定义日志格式spdlog 默认的日志格式已经包含时间、级别和消息但实际项目中往往需要更多信息比如线程号、logger 名称、源码文件名和行号。这些可以通过set_pattern设置。#include spdlog/spdlog.h int main() { spdlog::set_pattern([%Y-%m-%d %H:%M:%S.%e] [%^%l%$] [thread %t] %v); spdlog::info(this is a custom pattern log); return 0; }常用 pattern 占位符如下占位符含义%Y-%m-%d %H:%M:%S日期和时间%e毫秒部分%l日志级别%^ 和 %$设置和恢复日志级别颜色%t线程号%nlogger 名称%s源文件名%#源文件行号%v日志消息内容实际项目中我建议至少在 pattern 中包含时间、级别、线程号和消息内容。分布式系统还可以把 trace id 或 request id 放在消息中方便链路追踪。5.2 滚动文件日志生产环境最常见的是限制单个日志文件大小超过后自动切换文件并保留最近的 N 份历史日志。spdlog 用rotating_logger_mt实现#include spdlog/spdlog.h #include spdlog/sinks/rotating_file_sink.h int main() { // 单个文件最大 5MB最多保留 3 个文件 auto logger spdlog::rotating_logger_mt( rotating_logger, logs/rotate.log, 1024 * 1024 * 5, 3 ); for (int i 0; i 10000; i) { logger-info(log message {}, i); } return 0; }当rotate.log达到 5MB 时spdlog 会把它重命名为rotate.1.log旧的rotate.1.log变成rotate.2.log最多保留 3 个文件。这个机制能防止日志无限增长占满磁盘。5.3 每日文件日志服务器程序更适合按日期拆分日志每天一个文件便于后续归档和检索。#include spdlog/spdlog.h #include spdlog/sinks/daily_file_sink.h int main() { // 每天 0 点 0 分创建新文件 auto logger spdlog::daily_logger_mt(daily_logger, logs/daily.log, 0, 0); logger-info(todays log); return 0; }daily_logger_mt的第一个时间参数是小时第二个是分钟。它会在当前日期变化且达到设定时间后自动生成带日期后缀的新日志文件。5.4 多 logger 与日志分离在复杂项目中不同模块的日志往往需要分开管理。比如业务日志、系统日志、SQL 日志分别输出到不同目录。spdlog 支持创建多个命名 logger并通过spdlog::get在任意位置获取。// 多 logger 示例 #include spdlog/spdlog.h #include spdlog/sinks/basic_file_sink.h #include spdlog/sinks/stdout_color_sinks.h int main() { // 控制台 logger auto console spdlog::stdout_color_mt(console); // 业务日志文件 logger auto business spdlog::basic_logger_mt(business, logs/business.log); // 在其他代码位置通过名字获取已有 logger auto logger spdlog::get(business); if (logger) { logger-info(business event occurred); } spdlog::get(console)-info(console message); return 0; }这里有几个工程要点stdout_color_mt是带颜色的控制台 logger在 Visual Studio 调试器中也有较好体验。每个 logger 默认继承全局 level但可以单独调用set_level覆盖。spdlog::get返回std::shared_ptrspdlog::logger如果 logger 不存在会返回空指针使用前建议判空或者在程序初始化阶段统一创建并持有不要频繁在业务代码里按名字查找。5.5 自定义 sink当官方 sink 无法满足需求时继承sinks::base_sink实现一个自定义 sink 并不难。比如需要把日志写入消息队列或监控平台时可以重写sink_it_方法。典型结构如下#include spdlog/sinks/base_sink.h template typename Mutex class my_sink final : public spdlog::sinks::base_sinkMutex { protected: void sink_it_(const spdlog::details::log_msg msg) override { // 在这里处理 msg比如发送到远程收集服务 spdlog::memory_buf_t formatted; this-formatter_-format(msg, formatted); // 将 formatted 发送到远端 } void flush_() override { // 处理 flush 逻辑 } };自定义 sink 的复杂度适中但要注意线程安全性。如果 sink 内部需要访问共享资源应该使用_mt对应的互斥锁模板或自行加锁。6. 异步日志模式实践6.1 为什么需要异步日志服务端程序如果采用同步日志每次写日志都会产生一次文件 IO。在高 QPS 场景下日志写入的耗时可能累积到几十毫秒甚至更多直接影响接口响应时间。异步日志的核心思路是业务线程只把日志消息丢进内存队列后台线程池负责批量写入文件业务线程不会被 IO 阻塞。6.2 异步 logger 创建方式spdlog 提供了spdlog::init_thread_pool和create_async系列函数来创建异步 logger。// 异步日志示例 #include spdlog/spdlog.h #include spdlog/async.h #include spdlog/sinks/basic_file_sink.h int main() { // 初始化线程池队列大小 8192后台线程数 1 spdlog::init_thread_pool(8192, 1); // 创建异步文件 logger auto async_logger spdlog::create_asyncspdlog::sinks::basic_file_sink_mt( async_file_logger, logs/async.log ); for (int i 0; i 1000; i) { async_logger-info(async message {}, i); } // 退出前确保所有日志写完 spdlog::shutdown(); return 0; }这里有两个容易出错的细节。第一个是init_thread_pool的调用时机。它必须在使用任何异步 logger 之前执行否则 spdlog 会使用默认参数创建的线程池。默认线程池通常也够用但明确设置队列大小和线程数更可控。第二个是spdlog::shutdown()。异步模式下日志先进入内存队列由后台线程消费。如果程序直接退出队列中尚未写入文件的日志会丢失。调用shutdown()会等待后台线程完成当前队列的写入这是异步日志可靠性的关键一步。6.3 有界队列与丢弃策略create_async当队列满时新的日志消息会阻塞等待队列有空位这虽然保证了不丢日志但可能会让业务线程等待。如果希望在队列满时直接丢弃日志可以使用create_async_nb系列其中nb表示 non-blocking。#include spdlog/spdlog.h #include spdlog/async.h #include spdlog/sinks/stdout_color_sinks.h int main() { spdlog::init_thread_pool(1024, 1); // 非阻塞异步 logger队列满时丢弃新日志 auto logger spdlog::create_async_nbspdlog::sinks::stdout_color_sink_mt(async_nb); logger-info(message 1); logger-info(message 2); spdlog::shutdown(); return 0; }非阻塞模式更适合日志量巨大、且不允许业务线程等待的场景但要接受“极端情况下丢日志”的代价。从告警统计角度丢少量日志通常可以接受从审计角度这可能是不可接受的。6.4 flush 策略flush 是另一个需要关注的细节。默认情况下spdlog 会在以下时机触发 flush调用logger-flush()或spdlog::flush_all()。使用spdlog::flush_on(spdlog::level::warn)设置达到某个级别时自动 flush。使用spdlog::flush_every(std::chrono::seconds(3))设置每隔一段时间自动 flush 所有 logger。服务端程序通常建议设置flush_on(level::warn)保证 warn 及更严重的日志立即落盘而普通 info 日志按周期批量写入。这样兼顾性能和可靠性。7. MFC / Windows 桌面程序使用 spdlog 的注意事项Windows 桌面开发中MFC 项目接入 spdlog 很常见但有一些坑和典型控制台程序不一样。7.1 头文件路径与项目配置MFC 项目往往没有 CMake 或者使用的构建系统比较老。最简单的方式是下载 spdlog 源码把 include 目录配置到项目属性页的“C/C - 常规 - 附加包含目录”。如果使用 Visual Studio 的 vcpkg可以用 vcpkg 安装后通过#include spdlog/spdlog.h直接使用前提是项目开启了 MSBuild 的 vcpkg 集成。需要注意一点spdlog 默认使用 UTF-8 编码的字符串。MFC 项目通常默认使用 Unicode 字符集CString是CStringW。直接把CString传给 spdlog 的{}占位符并不会得到预期的可读内容需要先转成 UTF-8 的std::string。7.2 CString 转 UTF-8 示例// 在 MFC 项目中封装一个转换函数 #include spdlog/spdlog.h #include atlstr.h std::string CStringToUtf8(const CString str) { if (str.IsEmpty()) { return ; } int length WideCharToMultiByte( CP_UTF8, 0, str.GetString(), -1, nullptr, 0, nullptr, nullptr ); std::string result(length - 1, \0); WideCharToMultiByte( CP_UTF8, 0, str.GetString(), -1, result.data(), length, nullptr, nullptr ); return result; } void LogMfcMessage(const CString message) { spdlog::info([MFC] {}, CStringToUtf8(message)); }上面的代码使用WideCharToMultiByte将宽字符CString转换为 UTF-8 编码的std::string再交给 spdlog 输出。如果你在控制台或日志文件里看到中文乱码大概率就是没有做这一步编码转换。7.3 使用 MSVC 调试器输出在 Visual Studio 里调试 MFC 程序时可以在 Output 窗口直接看到日志这得益于 spdlog 的 msvc_sink。#include spdlog/spdlog.h #include spdlog/sinks/msvc_sink.h void InitDebugLogger() { auto msvc_logger spdlog::msvc_logger_mt(msvc); msvc_logger-set_level(spdlog::level::debug); msvc_logger-info(output to Visual Studio debug window); }msvc_sink 会把日志调用转换为OutputDebugStringA输出调试时非常方便生产环境则不应该使用它作为唯一输出。7.4 UI 线程与异步日志MFC 程序的主线程是 UI 线程如果在 UI 消息响应里直接写同步文件日志用户会感觉到界面卡顿。尤其是按钮点击、定时器回调这些高频场景日志量稍大就会拖慢消息循环。稳妥的做法是把 spdlog 初始化为异步 logger业务线程通过队列把日志交给后台线程UI 线程只做入队操作不会因为磁盘 IO 变慢。7.5 运行时库配置MFC 项目的 C/C 运行时库可能配置为多线程调试 /MTd、多线程 /MT、多线程 DLL /MD 等。如果 spdlog 是 header-only 方式使用它与你项目使用同一套运行时库问题不大。如果使用了 spdlog 的编译库版本则必须保证 spdlog 库和你的项目采用相同的运行时库配置否则会出现链接错误或运行时不匹配的问题。稳妥起见使用 header-only 方式接入 MFC 项目最省事。8. spdlog 常见问题与排查方法下面是接入 spdlog 时最常遇到的几类问题整理成排查表方便直接对照。问题现象可能原因排查方式解决方案编译报错找不到 spdlog.hinclude 目录未配置检查编译命令或项目属性页的附加包含目录下载 spdlog 后把 include 目录加入编译路径链接错误符号重定义或找不到符号使用了 SPDLOG_COMPILED_LIB 但未统一宏定义查看所有使用 spdlog 的文件是否包含相同宏统一要么全部 header-only要么全部定义 SPDLOG_COMPILED_LIB控制台输出乱码源文件编码与日志输出端编码不一致检查源码文件编码和终端代码页统一使用 UTF-8或在 Windows 使用 /utf-8 编译选项文件日志没有生成目录不存在或路径错误检查日志目录是否存在确认程序没有抛出异常创建目录或添加异常捕获查看错误信息异步模式退出时丢失日志没有调用 shutdown检查程序退出流程在 main 结束前调用 spdlog::shutdown()日志文件不断增长切割不生效rotating 参数设置不合理或文件被占用检查是否有进程持有日志文件句柄调低单文件大小上限或避免外部程序占用文件多线程日志顺序乱不同线程打印顺序确实无法严格保证确认是线程安全问题还是业务预期问题给日志加序号或时间戳按时间排序FetchContent 拉取 spdlog 缓慢网络问题或 GitHub 访问不稳定检查 CMake 下载输出改用源码拷贝或 vcpkg/Conan或使用镜像编译耗时明显增加头文件库导致每个翻译单元都解析 spdlog观察编译耗时使用预编译头或改为 SPDLOG_COMPILED_LIB 编译库方式MFC 中 CString 输出乱码宽字符未转 UTF-8打断点查看转换结果使用 WideCharToMultiByte 转换为 UTF-8排查 spdlog 问题时一个通用思路是先确认是编译期问题还是运行期问题然后分模块缩小范围。编译期问题优先看宏定义和头文件路径运行期问题优先看 logger 创建时的返回值、异常信息和目标目录权限。9. 工程最佳实践与生产环境建议9.1 封装自己的日志接口虽然 spdlog 的 API 已经很好用但建议在业务代码里再包一层薄封装而不是直接到处调用spdlog::info。原因是业务代码不应该依赖具体日志库实现未来如果切换到其他日志系统只需要改封装层。封装时保留 spdlog 的格式化能力同时统一传入模块名、业务关键词等上下文。// 简单封装示例 #pragma once #include spdlog/spdlog.h #include string namespace applog { void Init(bool async, const std::string log_dir); void Info(const std::string msg); void Warn(const std::string msg); void Error(const std::string msg); }当然封装也不要过度设计。小型项目直接使用 spdlog 的全局 logger 也非常合理关键是项目里要有统一的习惯。9.2 合理设置日志级别建议遵循以下原则开发环境默认输出 debug 或 trace方便排查。测试环境默认输出 info。生产环境默认输出 info 或 warn避免大量 debug 日志压垮磁盘。线上临时排查时通过配置中心或环境变量动态调整某模块的日志级别不建议修改代码后重新发布。可以用环境变量在启动时初始化日志级别例如读取MYAPP_LOG_LEVEL这样运维可以不改代码调整级别。9.3 日志文件管理生产环境建议至少做到使用 rotating 或 daily 日志设置大小上限和保留份数。日志目录单独规划不要和程序目录混在一起。定期检查磁盘占用设置日志文件老化删除策略。如果按天切分文件名中包含日期例如app-2024-06-01.log。9.4 性能优化注意点避免在日志消息里拼接大字符串尤其是循环中的高频日志。先判断该 level 是否开启再构造消息。使用SPDLOG_ACTIVE_LEVEL在编译期关闭低级别日志。异步模式下合理设置队列大小过小会丢日志过大占用内存。不要在日志格式中使用过于复杂的自定义格式化器每次日志输出都会执行一次格式化。9.5 安全与合规提醒日志中不要记录密码、密钥、token、身份证号、银行卡号等敏感信息。如果你确实需要记录请求参数用于排查对敏感字段做脱敏处理例如只保留前后几位。这类问题在日志系统上线后很容易被忽略等出了安全事故再整改代价很大。9.6 异常处理与降级日志系统本身也可能出问题比如磁盘满、目录权限错误、队列异常。生产环境建议对日志初始化做异常捕获避免日志库故障导致业务进程启动失败。极端情况下日志写入失败应该降级而不是阻塞业务这和使用异步非阻塞模式的选择是相关的。10. 总结与后续学习方向spdlog 之所以被广泛使用核心原因不是某个单点功能多么惊艳而是它把 C 项目日志系统的复杂度控制在了合理的范围内。logger 负责业务侧sink 负责输出侧formatter 负责展示侧异步线程池解决性能问题滚动和每日切割解决运维问题。理解这些概念后再去看它的源码会清晰很多。下一步建议做三件事第一用本文的示例在自己项目里跑通控制台日志和文件日志第二根据项目特点选择同步还是异步、rolling 还是 daily把日志级别和 flush 策略配置好第三如果对内部实现感兴趣可以按logger - sink - formatter - thread_pool的调用链读源码重点看异步队列和批量刷盘的实现。落地 spdlog 并不难但真正让日志系统在团队里发挥作用靠的是统一规范、合理配置和持续迭代。建议把这篇文章收藏备用在接入 spdlog 时对照检查能少踩很多不必要的坑。