1、日志系统基础：为什么实时系统需要日志？
做实时系统这么多年，我越来越觉得日志这东西，就像飞机的黑匣子。平时没人关心它，一旦出了事，它就是唯一的救命稻草。
你想想看，一个实时控制系统跑在生产线上，突然某天半夜报警了——电机过载、通信超时、看门狗复位。这时候你人不在现场，手里只有一堆寄存器值。你能怎么办？
嗯，这就是日志存在的意义。
为什么实时系统特别需要日志？
普通桌面程序崩了，你可以打断点、单步调试。但实时系统不一样——
- 不可中断性：生产线不能停，医疗设备不能停。你没法在客户现场打断点。
- 时序敏感：很多bug是时序问题，比如中断嵌套、任务抢占。单步调试会改变时序，bug反而复现不了。
- 资源受限：MCU的RAM可能只有几十KB，你连printf都不敢多用。
我在一个工业控制项目里遇到过这种事：设备运行8小时后偶发死机。用示波器抓了三天，愣是没抓到。后来加了环形日志，把关键变量的变化轨迹全记下来。第二天就定位到了——一个全局变量被中断和主循环同时访问，没有加锁。
说白了，日志就是你的第二双眼睛。它帮你看到代码运行时的真实状态。
核心观点：实时系统的日志，不是为了记录，而是为了事后还原现场。你记录的每一个时间戳、每一个状态变化，都是破案的关键线索。
日志级别：从DEBUG到FATAL
日志级别这东西，很多新手觉得无所谓。反正都打出来呗。但实际项目里，级别选错了，后果很严重。
我见过一个团队，DEBUG级别的日志在生产环境里开着。结果日志缓冲区每秒被刷爆，CPU占用率飙升30%，系统响应直接变慢。客户投诉说「你们的设备反应迟钝」。
所以，级别不是摆设。它是你控制日志开销的阀门。
| 级别 | 含义 | 典型场景 | 生产环境是否开启 |
|---|---|---|---|
| DEBUG | 调试信息 | 变量值、函数入口/出口、循环计数 | ❌ 关闭 |
| INFO | 常规信息 | 系统启动、任务切换、通信建立 | ✅ 开启 |
| WARN | 警告 | 资源接近上限、重试次数过多、时序偏差 | ✅ 开启 |
| ERROR | 错误 | 通信失败、传感器异常、任务超时 | ✅ 开启 |
| FATAL | 致命错误 | 看门狗复位、内存越界、系统崩溃 | ✅ 必须开启 |
级别选择策略：我的经验法则
级别怎么选？我个人的习惯是这么定的——
- DEBUG：只在开发阶段用。记录那些「我想知道它到底干了什么」的信息。比如PID控制器的每次迭代输出、状态机的每个跳转。生产环境里必须关掉，否则日志量会爆炸。
- INFO：记录系统正常运行的里程碑事件。比如「系统初始化完成」「通信链路建立」「任务A启动成功」。这些信息用来确认系统在按预期工作。
- WARN：记录那些「还没出问题，但快了」的情况。比如「内存使用率85%」「通信重试第3次」「任务执行时间超过预期」。我曾经靠一个WARN日志，提前发现了电机驱动芯片的过热趋势，避免了烧毁。
- ERROR：记录功能失效但系统还能继续跑的情况。比如「传感器读取失败，使用上次值」「CAN总线丢包，重发」。这些错误需要被监控和统计，但不会导致系统停机。
- FATAL：记录那些「系统已经没法玩了」的情况。比如「堆栈溢出」「看门狗复位」「关键任务崩溃」。FATAL日志通常伴随着系统重启或安全停机。
小技巧：我习惯在代码里用宏来控制日志级别。比如：
#define LOG_LEVEL LOG_LEVEL_INFO
#if LOG_LEVEL <= LOG_LEVEL_DEBUG
#define LOG_DEBUG(fmt, ...) log_output("DEBUG", fmt, ##__VA_ARGS__)
#else
#define LOG_DEBUG(fmt, ...) // 空定义，编译时直接优化掉
#endif这样DEBUG日志在编译阶段就被去掉了，零运行时开销。
避坑指南：我曾经踩过的坑
我曾经在一个项目里，把所有日志都设成了ERROR级别。心想「反正只记录错误，肯定没问题」。结果呢？系统崩溃前，日志缓冲区里全是「ERROR: 通信超时」「ERROR: 传感器无响应」——全是症状，没有病因。
后来我才明白：错误日志只能告诉你「出了什么事」，但WARN和INFO日志才能告诉你「为什么会出事」。
比如一个电机堵转故障。如果你只记录ERROR，你只能看到「电机堵转」。但如果你有WARN日志，你可能会看到「电机电流持续上升」「温度超过阈值」「转速下降」。这些才是真正的根因。
警告：千万不要在生产环境里开启DEBUG级别！除非你明确知道自己在做什么。DEBUG日志的写入速度可能比你的业务逻辑还慢，而且会大量消耗Flash寿命。我曾经见过一个产品，因为DEBUG日志没关，Flash在3个月内就被写报废了。
知识体系总览
下面这张图，是我对日志系统基础的理解。它把「为什么需要日志」「日志级别怎么选」「实际怎么用」串在了一起。
这张图想表达的是：日志不是孤立的技术点。它从「为什么需要」出发，决定了「级别怎么选」，然后落到「代码怎么写」和「坑怎么避」。每一步都环环相扣。
好了，日志基础就聊到这儿。记住一句话：好的日志系统，能让你在出问题时少熬三个通宵。
公众号:蓝海资料掘金营，微信deep3321