预处理指令：宏定义、文件包含与条件编译

预处理，说白了就是编译器在真正编译代码之前，先帮你做的一轮文本替换工作。我刚开始学C语言时，总觉得预处理是个可有可无的东西——不就是把#include的文件内容复制进来吗？后来做项目多了才发现，预处理指令用得好，代码能少写一半，bug也能少踩一半。

今天咱们就聊聊预处理指令里的三驾马车：宏定义、文件包含和条件编译。这三样东西，你写任何嵌入式项目都绕不开。

1. 宏定义 #define

宏定义，说白了就是文本替换。你告诉编译器：看到A就给我换成B。就这么简单。

1.1 无参数宏

最常见的用法就是定义常量。比如：

#define LED_PIN 13
#define BUFFER_SIZE 256
#define PI 3.1415926

我个人习惯把宏定义的名字全部大写，这样一眼就能看出来这是个宏，不是变量。你在代码里看到LED_PIN，就知道它是个常量，不会去修改它。

1.2 带参数的宏

带参数的宏，有点像函数，但又不是函数。它本质上还是文本替换。比如：

#define SQUARE(x) ((x) * (x))
#define MAX(a, b) ((a) > (b) ? (a) : (b))
#define ABS(x) ((x) < 0 ? -(x) : (x))

嗯，这里要注意一个经典坑：括号一定要加够。我在项目中遇到过这样一个bug：

// 错误的写法
#define SQUARE(x) x * x
// 调用
int y = SQUARE(2 + 3);  // 你以为结果是25，实际是2 + 3 * 2 + 3 = 11

为什么会这样？因为宏是文本替换，SQUARE(2+3)被替换成了2+3 * 2+3，乘法优先级高于加法，结果就错了。所以带参数的宏，参数和整个表达式都要加括号。

1.3 宏与函数的区别

对比项	宏	函数
执行时机	预处理阶段（编译前）	运行时
类型检查	无类型检查	有类型检查
代码体积	每次调用都展开，体积增大	只有一份代码，体积小
执行速度	无函数调用开销，快	有调用开销，稍慢
副作用	容易产生副作用（如多次计算参数）	参数只计算一次，安全

你想想看，如果只是简单的计算，用宏确实快。但如果逻辑复杂，或者参数有副作用（比如MAX(i++, j++)），那就老老实实用函数吧。

2. 文件包含 #include

#include的作用，就是把另一个文件的内容原封不动地复制到当前位置。就这么简单粗暴。

2.1 两种包含方式

#include <stdio.h>    // 标准库头文件，在系统路径中查找
#include "myheader.h" // 用户自定义头文件，先在当前目录查找

我个人习惯：系统头文件用尖括号，自己的头文件用双引号。这样别人看你的代码，一眼就能区分哪些是标准库，哪些是自己写的。

2.2 头文件应该放什么

头文件里一般放这些东西：

• 函数声明（原型）
• 宏定义
• 类型定义（typedef、struct等）
• 全局变量声明（用extern）
• 内联函数定义

头文件里不要放函数定义和变量定义。否则多个.c文件都包含同一个头文件，链接时就会报重复定义错误。

3. 条件编译 #ifdef / #ifndef

条件编译，就是让编译器根据条件决定哪些代码要编译，哪些不要编译。这在嵌入式开发中特别有用。

3.1 基本用法

#define DEBUG 1

#ifdef DEBUG
    printf("调试信息：x = %d\n", x);
#endif

#ifndef RELEASE
    printf("当前不是发布版本\n");
#endif

我在项目中经常用条件编译来控制调试输出。开发阶段打开调试宏，发布时关掉，不用删代码，也不用注释，干净利落。

3.2 防止头文件重复包含

这是条件编译最经典的应用。你想想看，如果a.h包含了b.h，c.h也包含了b.h，然后某个.c文件同时包含了a.h和c.h，那b.h的内容就被包含了两次，会报重复定义错误。

解决办法就是头文件保护：

#ifndef MYHEADER_H
#define MYHEADER_H

// 头文件内容写在这里

#endif

第一次包含时，MYHEADER_H没定义，所以进入#ifndef内部，然后定义了MYHEADER_H。第二次再包含时，MYHEADER_H已经定义了，就直接跳过整个文件内容。

3.3 平台兼容性

条件编译还可以用来处理不同平台的差异。比如：

#ifdef STM32
    #include "stm32_gpio.h"
#elif defined(ESP32)
    #include "esp32_gpio.h"
#else
    #include "generic_gpio.h"
#endif

这样一套代码可以适配多个平台，只需要在编译时定义不同的宏就行。

4. 知识体系总览

下面这张图总结了预处理指令的核心知识结构：

5. 综合示例

最后，咱们看一个综合示例，把今天讲的东西串起来：

// config.h
#ifndef CONFIG_H
#define CONFIG_H

#define LED_PIN 13
#define BUFFER_SIZE 256

#ifdef DEBUG
    #define LOG(msg) printf("[DEBUG] %s\n", msg)
#else
    #define LOG(msg) // 空宏，什么都不做
#endif

#endif // CONFIG_H

// main.c
#include "config.h"
#include <stdio.h>

int main() {
    LOG("程序启动");
    printf("LED引脚：%d\n", LED_PIN);
    LOG("程序结束");
    return 0;
}

你看，通过预处理指令，我们实现了：

• 用宏定义管理硬件引脚和缓冲区大小
• 用条件编译控制调试输出
• 用头文件保护防止重复包含

这就是预处理指令的魅力——让代码更灵活、更可维护。我在实际项目中，几乎每个头文件都会用到这三样东西，缺一不可。

---

公众号:蓝海资料掘金营，微信deep3321