8、条件编译调试：使用#ifdef/#ifndef控制调试代码，DEBUG宏的最佳实践
调试信息管理，说白了就是让代码在开发阶段“话多”，发布阶段“闭嘴”。
我早年做嵌入式项目时，就吃过这个亏。产品上线后，调试打印还开着，结果串口被日志刷爆，系统直接卡死。从那以后，条件编译就成了我写代码的标配。
8.1 为什么需要条件编译？
你想想看，调试代码和正式代码，本质上是两套逻辑。调试时我们需要打印变量、检查边界、输出堆栈；但发布时这些代码不仅没用，还会拖慢性能、浪费存储。
用#ifdef和#ifndef，就能让同一份源码，编译出两种行为。这就是条件编译的核心价值。
核心原则：调试代码只在 DEBUG 宏定义时生效，发布时自动消失，不留下任何痕迹。
8.2 DEBUG宏的最佳实践
我个人习惯，在项目头文件里统一控制 DEBUG 宏。不会把它散落在各个 .c 文件里，否则后期维护会疯掉。
/* debug_config.h */
#ifndef DEBUG_CONFIG_H
#define DEBUG_CONFIG_H
// 注释掉下面这行，就是发布模式
#define DEBUG_ENABLE
#ifdef DEBUG_ENABLE
#define DEBUG_PRINT(fmt, ...) printf("[DBG] " fmt "\r\n", ##__VA_ARGS__)
#else
#define DEBUG_PRINT(fmt, ...) // 空定义，编译后不产生任何代码
#endif
#endif /* DEBUG_CONFIG_H */这里有个细节：##__VA_ARGS__是 GNU C 的扩展语法，用于处理可变参数。如果你用标准 C，可以用__VA_ARGS__，但要注意空参数时的逗号问题。
8.3 #ifdef 与 #ifndef 的典型用法
我一般这样划分职责：
| 指令 | 典型场景 | 我的经验 |
|---|---|---|
#ifdef DEBUG |
启用调试打印、断言检查 | 最常用，配合 -DDEBUG 编译选项 |
#ifndef DEBUG |
发布模式下启用优化、禁用安全检查 | 用于关闭耗时的校验逻辑 |
#if defined(DEBUG) && (DEBUG_LEVEL > 2) |
分级调试，控制输出详细程度 | 大项目必备，避免信息过载 |
小技巧：我习惯在调试信息里加上文件名和行号，这样定位问题快得多。
#define DEBUG_PRINT(fmt, ...) \
printf("[%s:%d] " fmt "\r\n", __FILE__, __LINE__, ##__VA_ARGS__)8.4 避坑指南：我曾经踩过的雷
我曾经在某个项目中，把 DEBUG 宏定义在了某个 .c 文件里。结果其他模块引用时，条件编译全部失效。调试信息时有时无，排查了整整两天。
后来我定了个规矩：DEBUG 宏必须在全局头文件或编译命令行中定义。比如：
// 在 Makefile 或 IDE 中统一添加
-DDEBUG
// 或者放在项目级的 config.h 中
#define DEBUG另一个常见坑是：#ifdef 和 #if 混用。比如：
// 错误写法
#define DEBUG 0
#ifdef DEBUG // 这里永远为真，因为 DEBUG 被定义了
// 即使 DEBUG=0，这段代码也会编译
#endif
// 正确写法
#define DEBUG 0
#if DEBUG // 这里才会判断值是否为 0
// 只有 DEBUG 非 0 时才编译
#endif嗯，这里要注意：#ifdef 只检查宏是否被定义，不关心它的值。而 #if 会计算宏的值。两者用途完全不同。
8.5 分级调试：从入门到精通
项目大了以后，单一开关就不够用了。我一般会设计三级调试：
#define DEBUG_LEVEL_NONE 0 // 关闭所有调试
#define DEBUG_LEVEL_ERROR 1 // 只输出错误
#define DEBUG_LEVEL_WARN 2 // 输出警告和错误
#define DEBUG_LEVEL_INFO 3 // 输出全部信息
#ifndef DEBUG_LEVEL
#define DEBUG_LEVEL DEBUG_LEVEL_NONE
#endif
#if DEBUG_LEVEL >= DEBUG_LEVEL_ERROR
#define LOG_ERROR(fmt, ...) printf("[ERR] " fmt "\r\n", ##__VA_ARGS__)
#else
#define LOG_ERROR(fmt, ...)
#endif
#if DEBUG_LEVEL >= DEBUG_LEVEL_WARN
#define LOG_WARN(fmt, ...) printf("[WRN] " fmt "\r\n", ##__VA_ARGS__)
#else
#define LOG_WARN(fmt, ...)
#endif
#if DEBUG_LEVEL >= DEBUG_LEVEL_INFO
#define LOG_INFO(fmt, ...) printf("[INF] " fmt "\r\n", ##__VA_ARGS__)
#else
#define LOG_INFO(fmt, ...)
#endif这样做的好处是：开发阶段设成 DEBUG_LEVEL_INFO，看所有信息；联调阶段降到 DEBUG_LEVEL_WARN，减少干扰；发布时直接 DEBUG_LEVEL_NONE，零开销。
8.6 条件编译的完整流程图
下面这张图，是我做项目时总结的条件编译决策流程。你可以照着这个思路来设计自己的调试系统：
8.7 实际项目中的配置示例
最后，分享一个我在 STM32 项目里实际用过的配置。它结合了条件编译和分级调试：
/* project_config.h */
#ifndef PROJECT_CONFIG_H
#define PROJECT_CONFIG_H
// 调试开关：0=关闭，1=错误，2=警告，3=信息
#define DEBUG_LEVEL 3
// 模块级调试开关
#define DEBUG_MODULE_UART 1
#define DEBUG_MODULE_SPI 1
#define DEBUG_MODULE_I2C 0 // I2C 模块暂时关闭调试
// 调试输出宏
#if DEBUG_LEVEL >= 3
#define DBG_INFO(mod, fmt, ...) \
if(DEBUG_MODULE_##mod) \
printf("[INFO][%s] " fmt "\r\n", #mod, ##__VA_ARGS__)
#else
#define DBG_INFO(mod, fmt, ...)
#endif
#endif /* PROJECT_CONFIG_H */使用时，只需要写：
DBG_INFO(UART, "发送完成，共 %d 字节", len);如果 DEBUG_MODULE_UART 为 0，这行代码在编译阶段就被完全移除。既灵活又高效。
重要提醒：条件编译不是万能的。如果调试代码改变了数据结构或函数接口，发布时去掉调试宏可能会导致编译错误。我建议把调试相关的代码独立成函数，用宏控制是否调用，而不是直接散落在业务逻辑里。
好了，关于条件编译调试，我就讲这么多。记住一句话：调试代码是开发者的朋友，但不能让它跑到用户面前。用好 #ifdef 和 #ifndef，你的代码会既干净又强大。
公众号:蓝海资料掘金营，微信deep3321