目录
一、核心概念：Keil 中的预处理伪指令
二、常用条件编译伪指令全解析
1. 基础定义 / 取消定义：#define / #undef
2. 核心条件编译指令
3. 进阶用法
(1) #if 结合逻辑运算符（Keil 完全支持）
(2) defined() 运算符（推荐）
(3) Keil 特有的宏定义方式
(4) 嵌套条件编译（Keil 支持多层嵌套）
4. 易错点与注意事项
三、实战示例（Keil 中常用场景）
总结
详细了解 Keil MDK 编译器中#if、#ifdef等预处理伪指令的完整用法，这是嵌入式开发中非常核心的知识点，尤其是在代码模块化、条件编译和多版本适配时频繁用到。
一、核心概念：Keil 中的预处理伪指令
Keil MDK 使用 ARMCC/ARMCLANG 编译器，其预处理伪指令遵循 ANSI C 标准，作用是在编译前对代码进行文本替换、条件筛选等处理，不参与程序运行，最终生成的二进制文件中不会包含这些指令。
二、常用条件编译伪指令全解析
1. 基础定义 / 取消定义：#define/#undef
这是条件编译的基础，用于定义宏（无值 / 有值）或取消已定义的宏。
// 1. 无值宏（仅标记“已定义”） #define DEBUG // 定义DEBUG宏，无具体值 #define ENABLE_UART // 定义启用串口的宏 // 2. 有值宏（带常量/表达式） #define BAUDRATE 115200 // 定义波特率为115200 #define MAX_NUM (100 + 20) // 支持简单表达式 // 3. 取消宏定义 #undef DEBUG // 取消DEBUG宏的定义2. 核心条件编译指令
| 伪指令 | 作用 | 示例 |
|---|---|---|
#ifdef | 检查宏是否已定义（无论值是多少），成立则编译后续代码 | #ifdef DEBUG <br> printf("调试模式\n"); <br> #endif |
#ifndef | 检查宏是否未定义，成立则编译后续代码（与 #ifdef 相反） | #ifndef DEBUG <br> printf("非调试模式\n"); <br> #endif |
#if | 检查表达式是否为真（非 0），支持数值比较、逻辑运算 | #if BAUDRATE == 115200 <br> uart_init(115200); <br> #endif |
#elif | 相当于 “else if”，配合 #if/ifdef 使用 | #if BAUDRATE == 9600 <br> ... <br> #elif BAUDRATE == 115200 <br> ... <br> #endif |
#else | 条件不成立时编译后续代码 | #ifdef DEBUG <br> ... <br> #else <br> ... <br> #endif |
#endif | 结束条件编译块（必须配对） | 所有条件编译指令都需以 #endif 结尾 |
3. 进阶用法
(1)#if结合逻辑运算符（Keil 完全支持）
#define PRODUCT_VERSION 2 #define ENABLE_BLUETOOTH 1 // 多条件组合：版本2 且 蓝牙启用 #if (PRODUCT_VERSION == 2) && (ENABLE_BLUETOOTH == 1) void bluetooth_init(void); // 声明蓝牙初始化函数 #endif // 或运算：版本1 或 版本3 #if (PRODUCT_VERSION == 1) || (PRODUCT_VERSION == 3) #define MAX_BUFFER 512 #else #define MAX_BUFFER 1024 #endif // 非运算：未定义DEBUG #if !defined(DEBUG) // 等价于 #ifndef DEBUG #define LOG_LEVEL 0 #endif(2)defined()运算符（推荐）
defined(宏名)用于判断宏是否定义，比#ifdef更灵活（可嵌入 #if 表达式）：
// 等价写法对比 #ifdef DEBUG // 写法1：简洁 ... #endif #if defined(DEBUG) // 写法2：可组合逻辑 ... #endif // 复杂组合：同时定义DEBUG和RELEASE则报错（Keil中#error会终止编译） #if defined(DEBUG) && defined(RELEASE) #error "不能同时定义DEBUG和RELEASE！" #endif(3) Keil 特有的宏定义方式
除了代码中#define，还可通过 Keil 界面定义宏（无需修改代码）：
- 打开 Keil 工程 → 点击魔法棒（Target Options）；
- 切换到
C/C++选项卡； - 在
Define栏输入宏（多个宏用逗号分隔，如DEBUG,BAUDRATE=115200）； - 点击 OK，编译器会自动将这些宏全局生效。
(4) 嵌套条件编译（Keil 支持多层嵌套）
#define HARDWARE_V1 1 #define ENABLE_USB 1 #ifdef HARDWARE_V1 #if ENABLE_USB == 1 #define USB_PORT 0 #else #define USB_PORT -1 #endif #else #define USB_PORT 1 #endif4. 易错点与注意事项
#ifdefine是笔误：正确写法是#ifdef，Keil 中写#ifdefine会直接编译报错；- 宏值的类型：
#if判断的是常量表达式，不能用变量（如int a=1; #if a==1会报错）； - 空格问题：
#ifdef DEBUG中#ifdef和DEBUG之间的空格可有可无，但推荐加空格增强可读性； #undef的作用域：#undef仅取消后续代码中该宏的定义，不影响前面的代码；- 空宏的处理：
#define DEBUG等价于#define DEBUG 1，#if DEBUG会判定为真。
三、实战示例（Keil 中常用场景）
#include <stdio.h> // 1. 调试模式开关 #define DEBUG 1 // 2. 硬件版本适配 #define HARDWARE_VERSION 2 int main(void) { // 调试信息打印 #ifdef DEBUG printf("程序启动，硬件版本：%d\n", HARDWARE_VERSION); #endif // 硬件版本适配 #if HARDWARE_VERSION == 1 printf("适配V1硬件：初始化串口1\n"); #elif HARDWARE_VERSION == 2 printf("适配V2硬件：初始化串口2+CAN\n"); #else #warning "未定义的硬件版本！" // Keil中#warning会提示但不终止编译 printf("默认硬件配置\n"); #endif return 0; }总结
- 核心指令分工：
#ifdef/#ifndef仅判断宏 “是否定义”，#if可判断宏的具体值（支持逻辑运算），所有条件编译必须以#endif结尾； - 灵活定义宏：除了代码中
#define，还可通过 Keil 界面的C/C++ Define栏全局定义宏，适配不同项目版本； - 避坑要点：
#ifdefine是错误写法（正确为#ifdef），#if仅支持常量表达式，嵌套编译需注意层级配对。
)