日志系统的现代化：从printf到分级日志、引入log4c、日志性能优化

说实话，我见过太多C语言项目，日志系统就靠一句printf打天下。刚开始写的时候觉得挺爽，调试信息随便打。等到项目上了生产环境，问题就来了——日志刷屏、性能下降、关键信息被淹没。嗯，这坑我踩过不止一次。

今天咱们聊聊，怎么把日志系统从原始社会带到现代化。

为什么printf不够用了？

你想想看，printf本身没什么错。它简单、直接、谁都会用。但问题在于：

• 没有分级：DEBUG、INFO、WARN、ERROR全混在一起
• 没有开关：要么全打，要么全关
• 没有格式控制：时间戳、文件名、行号全靠手写
• 性能开销大：格式化输出在关键路径上很要命

我在一个嵌入式项目中就吃过这个亏。生产环境日志刷爆了串口缓冲区，导致主任务被阻塞。查了两天才发现，是某个循环里忘了关调试打印。

分级日志：给日志贴上标签

现代化的第一步，就是给日志分级。说白了，就是让不同重要性的信息走不同的通道。

常见的分级标准：

级别	含义	使用场景
FATAL	致命错误	系统无法继续运行
ERROR	错误	功能异常，但系统可继续
WARN	警告	潜在问题，值得关注
INFO	信息	关键流程节点
DEBUG	调试	开发阶段使用
TRACE	跟踪	细粒度流程追踪

实现起来其实不复杂。一个简单的宏定义就能搞定：

#define LOG_LEVEL_NONE    0
#define LOG_LEVEL_FATAL   1
#define LOG_LEVEL_ERROR   2
#define LOG_LEVEL_WARN    3
#define LOG_LEVEL_INFO    4
#define LOG_LEVEL_DEBUG   5
#define LOG_LEVEL_TRACE   6

// 全局日志级别，可在运行时调整
extern int g_log_level;

#define LOG_FATAL(fmt, ...) \
    do { if (g_log_level >= LOG_LEVEL_FATAL) \
        fprintf(stderr, "[FATAL] %s:%d: " fmt "\n", \
                __FILE__, __LINE__, ##__VA_ARGS__); \
    } while(0)

#define LOG_ERROR(fmt, ...) \
    do { if (g_log_level >= LOG_LEVEL_ERROR) \
        fprintf(stderr, "[ERROR] %s:%d: " fmt "\n", \
                __FILE__, __LINE__, ##__VA_ARGS__); \
    } while(0)

引入log4c：别重复造轮子

自己手写分级日志虽然能用，但功能有限。我建议你直接引入log4c这个库。它借鉴了Java生态的log4j设计思路，在C语言里实现了类似的能力。

log4c的核心概念：

• Logger：日志记录器，每个模块可以有自己的logger
• Appender：输出目标，可以是文件、控制台、syslog等
• Layout：输出格式，控制时间戳、级别、消息的排列方式

一个典型的log4c配置示例：

// log4crc配置文件
<log4c>
  <category name="myapp.network" priority="DEBUG" />
  <category name="myapp.database" priority="INFO" />

  <appender name="stdout" type="stream" />
  <appender name="file" type="rollingfile">
    <param name="file" value="/var/log/myapp.log" />
    <param name="maxsize" value="10485760" /> <!-- 10MB -->
    <param name="maxnum" value="5" />
  </appender>

  <layout name="basic" type="basic" />
  <layout name="dated" type="dated" />
</log4c>

代码里使用也很简单：

#include <log4c.h>

int main() {
    log4c_init();

    log4c_category_t* mycat = log4c_category_get("myapp.network");

    log4c_category_debug(mycat, "Connecting to server %s", "192.168.1.1");
    log4c_category_info(mycat, "Connection established");
    log4c_category_error(mycat, "Connection timeout after %d ms", 5000);

    log4c_fini();
    return 0;
}

日志性能优化：别让日志拖垮系统

日志系统引入后，性能问题就浮出水面了。你想想看，每条日志都要格式化字符串、写文件、可能还要加锁。在高并发场景下，这可不是小开销。

我总结了几条优化经验：

1. 异步日志

把日志写入操作放到后台线程。主线程只负责把日志消息塞进队列，由专门的写线程处理IO。这样主线程不会被日志阻塞。

// 伪代码示意
void log_async(const char* msg) {
    // 1. 将消息放入环形缓冲区
    ringbuf_push(g_log_buf, msg);
    // 2. 唤醒写线程
    sem_post(&g_log_sem);
}

void* log_writer_thread(void* arg) {
    while (1) {
        sem_wait(&g_log_sem);
        char* msg = ringbuf_pop(g_log_buf);
        fwrite(msg, 1, strlen(msg), g_log_file);
        fflush(g_log_file);
    }
}

2. 日志分级预判

在格式化字符串之前，先判断当前级别是否满足输出条件。避免不必要的格式化开销。

// 不好的写法
log_debug("Processing item %d with value %s", id, expensive_to_string(obj));

// 好的写法
if (log_level >= LOG_LEVEL_DEBUG) {
    log_debug("Processing item %d with value %s", id, expensive_to_string(obj));
}

3. 批量写入

不要每条日志都刷盘。攒一批再写，能大幅减少IO次数。

4. 使用内存映射文件

对于高性能场景，可以考虑用mmap把日志文件映射到内存。写入操作直接操作内存，由操作系统负责刷盘。

知识体系总览

下面这张图，把日志系统现代化的核心脉络梳理了一遍：

避坑指南

最后分享几个我踩过的坑：

• 日志文件不轮转：我曾经有个项目，日志文件涨到几个GB，服务器磁盘直接爆了。一定要配置日志轮转策略。
• 日志锁竞争：多线程环境下，如果所有线程共用一个日志文件，锁竞争会非常严重。可以考虑每个线程一个缓冲区，或者用无锁队列。
• 敏感信息泄露：日志里不要打印密码、密钥、用户隐私数据。我见过有人把数据库连接密码直接打出来的……
• 日志级别设置不当：生产环境开DEBUG级别，性能直接腰斩。上线前记得把级别调到INFO或WARN。

日志系统看似简单，但设计得好能救命，设计得烂能坑人。从printf到分级日志，再到log4c和性能优化，每一步都是经验的积累。希望这些内容对你有帮助。

---