第5章条件编译（#if, #ifdef, #ifndef, #else, #elif,

课程目录第5章条件编译（#if, #ifdef, #ifndef, #else, #elif,

5、条件编译（#if, #ifdef, #ifndef, #else, #elif, #endif）：调试开关的实现，平台兼容性代码，头文件保护符

条件编译，说白了就是让编译器“挑着看代码”。

同一份源文件，在不同平台、不同配置下，编译出来的东西可以完全不一样。我刚开始接触嵌入式开发时，觉得这玩意儿不就是个高级版的if-else吗？后来被坑过几次才明白——它是在编译阶段就决定代码的去留，跟运行时的那套逻辑完全是两码事。

5.1 条件编译的核心指令

先列一下家底。C语言预处理阶段，跟条件判断相关的指令就这么几个：

指令	含义	典型用法
`#if`	如果表达式为真，则编译后续代码	`#if DEBUG_LEVEL > 2`
`#ifdef`	如果宏已定义，则编译后续代码	`#ifdef STM32F4`
`#ifndef`	如果宏未定义，则编译后续代码	`#ifndef HEADER_H`
`#else`	与#if/#ifdef/#ifndef配对，取反分支	`#else`
`#elif`	else if的预处理版本	`#elif defined(PLATFORM_B)`
`#endif`	结束条件编译块	`#endif`

嗯，这里要注意一个细节：#ifdef 和 #if defined() 在效果上是等价的，但后者更灵活——你可以写 #if defined(A) && !defined(B) 这种复合条件。我个人习惯用 #if defined()，因为可读性更好，尤其当条件变复杂时。

5.2 调试开关的实现

我在项目中遇到过最典型的场景：调试日志。

产品代码里不能有printf满天飞，但开发阶段又离不开它。怎么办？条件编译就是标准答案。

// debug.h
#ifndef DEBUG_H
#define DEBUG_H

// 调试级别：0=关闭，1=错误，2=警告，3=信息，4=详细
#define DEBUG_LEVEL 3

#if DEBUG_LEVEL >= 1
  #define LOG_ERROR(fmt, ...) printf("[ERROR] " fmt "\n", ##__VA_ARGS__)
#else
  #define LOG_ERROR(fmt, ...) // 空定义
#endif

#if DEBUG_LEVEL >= 2
  #define LOG_WARN(fmt, ...)  printf("[WARN]  " fmt "\n", ##__VA_ARGS__)
#else
  #define LOG_WARN(fmt, ...)
#endif

#if DEBUG_LEVEL >= 3
  #define LOG_INFO(fmt, ...)  printf("[INFO]  " fmt "\n", ##__VA_ARGS__)
#else
  #define LOG_INFO(fmt, ...)
#endif

#endif // DEBUG_H

你看，发布时只要把 DEBUG_LEVEL 改成 0，所有日志代码就凭空消失了——不是被注释掉，而是压根不会被编译器看到。这样既不影响性能，也不占代码空间。

小技巧： 调试宏里用 ##__VA_ARGS__ 这个写法，是GCC扩展，支持可变参数为空的情况。如果你用MSVC，得换成 __VA_ARGS__ 加额外处理。跨平台时要注意这个差异。

5.3 平台兼容性代码

做嵌入式的人都知道，换芯片是家常便饭。同一套逻辑，今天跑在STM32上，明天可能就要移植到GD32或者AT32上。寄存器地址不一样，外设库不一样，甚至字节序都可能不一样。

条件编译就是解决这个问题的利器。

// platform.h
#ifndef PLATFORM_H
#define PLATFORM_H

// 选择平台：在编译命令行中定义，例如 -DPLATFORM_STM32F4
// #define PLATFORM_STM32F4
// #define PLATFORM_GD32F3
// #define PLATFORM_AT32F4

#if defined(PLATFORM_STM32F4)
  #include "stm32f4xx.h"
  #define LED_PORT       GPIOA
  #define LED_PIN        GPIO_PIN_5
  #define SYSTICK_FREQ   1000

#elif defined(PLATFORM_GD32F3)
  #include "gd32f3xx.h"
  #define LED_PORT       GPIOA
  #define LED_PIN        GPIO_PIN_1
  #define SYSTICK_FREQ   1000

#elif defined(PLATFORM_AT32F4)
  #include "at32f4xx.h"
  #define LED_PORT       GPIOA
  #define LED_PIN        GPIO_PIN_6
  #define SYSTICK_FREQ   1000

#else
  #error "No platform defined! Please define PLATFORM_xxx in compiler flags."

#endif

#endif // PLATFORM_H

这样写的好处是：应用层代码完全不用关心底层差异。你写 HAL_GPIO_WritePin(LED_PORT, LED_PIN, SET)，至于这个宏展开成什么，那是平台层的事。

避坑指南： 我曾经在一个项目里看到有人把平台判断写在.c文件里，结果换平台时要改十几个文件。正确的做法是：把所有平台相关的宏定义集中到一个头文件里，其他文件只包含这个头文件。这样换平台时只需要改一个地方，或者改编译脚本里的 -D 参数。

5.4 头文件保护符

这个应该是每个C程序员最早接触的条件编译用法。但我发现很多新手只是机械地抄，并不理解为什么需要它。

原因很简单：C语言不允许同一个结构体、同一个枚举、同一个函数声明被定义两次。当头文件被间接包含多次时——比如a.h包含了b.h，c.h也包含了b.h，然后某个.c文件同时包含了a.h和c.h——如果没有保护符，b.h的内容就会被展开两次，编译器直接报重复定义错误。

// sensor.h
#ifndef SENSOR_H      // 如果 SENSOR_H 未定义，说明是第一次包含
#define SENSOR_H      // 定义 SENSOR_H，防止后续再次包含

typedef struct {
    uint16_t id;
    float    temperature;
    float    humidity;
} SensorData_t;

void Sensor_Init(void);
float Sensor_ReadTemperature(void);

#endif // SENSOR_H    // 结束保护

这个模式有个专门的名字叫“include guard”。标准写法就是三件套：#ifndef + #define + #endif。

  注意： 宏的名字最好跟文件名对应，比如 sensor.h 就用 SENSOR_H。不要用 _SENSOR_H 这种以下划线开头的名字——C标准保留了下划线+大写字母开头的标识符给编译器内部使用，撞上了可能会有诡异的问题。

另外提一句，现在很多编译器支持 #pragma once，效果跟头文件保护符一样，而且更简洁。但它的缺点是：不是C标准的一部分，有些老编译器不支持。我个人建议：如果你确定项目只用GCC或Clang，用 #pragma once 没问题；如果要兼容各种编译器，老老实实用传统保护符。

5.5 条件编译的嵌套与注意事项

条件编译可以嵌套，但嵌套多了代码可读性会急剧下降。我见过一个项目，一个函数里嵌套了七八层 #ifdef，看得人头皮发麻。

// 不推荐：嵌套太深
#ifdef FEATURE_A
  #ifdef FEATURE_B
    #ifdef DEBUG
      do_something_complex();
    #else
      do_something_simple();
    #endif
  #else
    // ...
  #endif
#else
  // ...
#endif

这种代码，过两周你自己回来看都可能搞不清哪个 #endif 对应哪个 #ifdef。我的建议是：

嵌套不超过3层
每层缩进清晰
在 #endif 后面加注释，标明它对应哪个条件
如果逻辑太复杂，考虑拆成多个小函数，用条件编译选择调用哪个函数

5.6 知识体系总览

下面这张图把条件编译的核心脉络梳理了一下，你可以对照着回顾：

5.7 一些实战经验

最后分享几个我踩过的坑，希望能帮你少走弯路：

#if 后面的表达式必须是常量。你不能写 #if (x > 5)，因为x是变量，预处理阶段根本不知道x的值。要用 #if (MACRO_VAL > 5)，其中MACRO_VAL是一个宏。
小心 #ifdef 和 #if defined() 的细微差别。#ifdef A 只检查A是否被定义，不管它的值是什么。而 #if A 会把A展开成数值再判断——如果A被定义为0，#if A 是假，但 #ifdef A 是真。这个区别曾经让我排查了一个下午的bug。
条件编译里的代码也要保证语法正确。很多人以为不编译的代码就可以随便写，错了。预处理器虽然跳过了这些代码，但编译器仍然会做基本的词法分析。所以被跳过的分支里如果有语法错误，照样编译不过。
不要用条件编译来替代函数抽象。如果一个功能在不同平台下的实现差异很大，优先考虑用函数指针或者抽象接口层，而不是满屏的 #ifdef。条件编译适合“小差异”，不适合“大重构”。

条件编译用好了，能让你的代码像变色龙一样适应各种环境。用不好，就是一团乱麻。记住一个原则：能用设计模式解决的问题，就不要用预处理。预处理是最后的手段，不是第一选择。

📚 课程目录

5、条件编译（#if, #ifdef, #ifndef, #else, #elif, #endif）：调试开关的实现，平台兼容性代码，头文件保护符

5.1 条件编译的核心指令

5.2 调试开关的实现

5.3 平台兼容性代码

5.4 头文件保护符

5.5 条件编译的嵌套与注意事项

5.6 知识体系总览

5.7 一些实战经验