2、日志框架选型：主流C/C++日志库对比与选型指南

做嵌入式实时控制系统这些年，我踩过最多的坑，其实不是业务逻辑写错了，而是——日志没打好。系统跑着跑着突然崩了，你连它死前最后一句话是什么都不知道。那种感觉，就像你女朋友突然拉黑你，你连个解释的机会都没有。

所以今天咱们聊聊日志库的选型。说白了，就是给你的系统装个「黑匣子」。我见过不少团队，一开始随便选个日志库，等到系统出问题要排查时，才发现日志要么丢了，要么性能拖垮了系统，要么格式乱得根本没法解析。嗯，选型这事，真得认真对待。

2.1 选型之前，先想清楚你要什么

我个人习惯，在选任何组件之前，先列需求清单。日志库也不例外。你想想看，一个实时控制系统对日志的要求，跟一个Web后端能一样吗？

我总结了几条硬指标：

• 性能：实时系统里，日志不能成为瓶颈。我曾经在一个电机控制项目里，因为日志写得太频繁，导致控制周期从1ms被拖到了3ms。嗯，那感觉就像你开车时副驾一直拽你方向盘。
• 异步支持：主线程绝对不能阻塞在日志写入上。这是底线。
• 资源占用：嵌入式环境里，内存和CPU都是稀缺资源。一个日志库吃掉几百KB的RAM？对不起，用不起。
• 格式化能力：能不能方便地输出时间戳、线程ID、文件名、行号？这些在调试时太重要了。
• 多线程安全：实时系统里多线程是常态，日志库必须线程安全。
• 轮转与归档：日志文件不能无限增长，否则存储会爆。我记得有个项目，日志文件写到了几个GB，最后系统因为磁盘满直接挂了。

2.2 三巨头：spdlog、log4cxx、zlog

目前C/C++领域，主流的日志库就这三个。我挨个说说我的使用感受。

2.2.1 spdlog —— 现代C++的首选

spdlog是我目前用得最多的库。它只包含头文件，用起来非常轻便。性能方面，它做了很多优化，比如用fmt库做格式化，比传统的sprintf快不少。

它的核心优势：

• 纯头文件，集成简单，不需要编译成库
• 支持异步日志，有独立的后台线程处理写入
• 支持多种输出目标：控制台、文件、syslog、甚至自定义sink
• 支持日志轮转，按大小或时间切分文件
• 格式化灵活，支持自定义模式

来个简单的例子：

#include "spdlog/spdlog.h"
#include "spdlog/sinks/rotating_file_sink.h"

int main() {
    // 创建一个轮转文件日志，每个文件5MB，最多保留3个
    auto logger = spdlog::rotating_logger_mt("file_logger", "logs/system.log", 5 * 1024 * 1024, 3);
    
    // 设置日志级别
    logger->set_level(spdlog::level::debug);
    
    // 记录日志
    logger->info("系统启动成功，CPU频率: {} MHz", 1200);
    logger->warn("内存使用率超过阈值: {}%", 85.3);
    logger->error("传感器通信超时，重试次数: {}", 3);
    
    return 0;
}

2.2.2 log4cxx —— 老牌劲旅，但有点重

log4cxx是Apache的项目，从Java的log4j移植过来的。功能非常强大，配置方式也跟log4j很像，支持XML配置文件。但说实话，在嵌入式领域，它有点水土不服。

它的特点：

• 配置灵活，支持层级化的logger命名空间
• 支持多种Appender（输出目标）和Layout（格式）
• 有完善的日志级别控制（TRACE, DEBUG, INFO, WARN, ERROR, FATAL）
• 依赖较多，需要apr库，编译配置比较麻烦

我曾经在一个工控项目里用过log4cxx，当时团队里有人熟悉Java的log4j，觉得用起来顺手。但后来发现，它的内存占用比spdlog大了将近3倍，而且启动时加载XML配置会消耗不少时间。对于需要快速启动的实时系统来说，这不太友好。

2.2.3 zlog —— C语言项目的利器

zlog是纯C写的日志库，作者是国人。如果你还在用C语言做嵌入式开发，zlog是个不错的选择。它非常轻量，几乎没有依赖，编译出来的库只有几十KB。

它的亮点：

• 纯C实现，兼容性极好，任何C/C++项目都能用
• 通过配置文件控制日志行为，运行时可以动态调整
• 支持日志分类（Category），不同模块可以有不同的日志级别和输出目标
• 性能不错，比log4cxx快，跟spdlog接近

看看zlog怎么用：

#include "zlog.h"

int main() {
    // 加载配置文件
    int rc = zlog_init("zlog.conf");
    if (rc) {
        printf("zlog初始化失败\n");
        return -1;
    }
    
    // 获取一个分类
    zlog_category_t *cat = zlog_get_category("my_cat");
    if (!cat) {
        zlog_fini();
        return -1;
    }
    
    // 记录日志
    zlog_info(cat, "系统启动成功，CPU频率: %d MHz", 1200);
    zlog_warn(cat, "内存使用率超过阈值: %.1f%%", 85.3);
    zlog_error(cat, "传感器通信超时，重试次数: %d", 3);
    
    zlog_fini();
    return 0;
}

对应的配置文件 zlog.conf 长这样：

[global]
buffer min = 256
buffer max = 2M

[formats]
simple = "%d(%Y-%m-%d %H:%M:%S) %-5V [%f:%L] %m%n"

[rules]
my_cat.*     >stdout; simple
my_cat.*     >file; /var/log/system.log, 5MB * 3; simple

2.3 横向对比：一张表说清楚

我整理了一个对比表格，方便你快速决策：

特性	spdlog	log4cxx	zlog
语言	C++11/14/17	C++	C
集成方式	纯头文件	需编译成库	需编译成库
依赖	fmt库（可选）	apr, apr-util	无
异步支持	优秀，独立线程池	一般，队列满会阻塞	支持，但需配置
内存占用	低（约50KB）	高（约200KB+）	极低（约30KB）
配置方式	代码配置	XML配置文件	自定义配置文件
性能（每秒写次数）	约500万次	约100万次	约300万次
适用场景	现代C++项目、嵌入式	大型企业级C++项目	C语言项目、资源受限环境

2.4 我的选型建议

说了这么多，到底怎么选？我给出几条实际建议：

1. 如果你用C++11及以上，且项目是新的：无脑选spdlog。它性能好、集成简单、社区活跃。我最近三个项目都用的它，没出过问题。
2. 如果你还在用C语言，或者资源极度受限：选zlog。它轻量、稳定、配置灵活。我有个跑在Cortex-M4上的项目，RAM只有128KB，zlog跑得稳稳的。
3. 如果你团队里有人熟悉log4j，且项目不要求极致性能：可以考虑log4cxx。但要做好心理准备，它的编译配置可能会让你折腾半天。
4. 如果你做的是硬实时系统：不管选哪个库，一定要用异步模式，并且把日志队列大小和写入频率调好。我曾经在一个周期只有500μs的控制循环里，把日志级别设成了DEBUG，结果系统直接崩了。嗯，那是我职业生涯里最尴尬的一次事故。

2.5 知识体系总览

最后，我用一张图把这一章的核心逻辑串起来。你一看就明白了：

这张图把选型的逻辑理得很清楚。你从需求出发，对照三个候选库的特点，最后根据你的实际场景做决策。说白了，没有最好的库，只有最合适的库。

---