C 语言预处理器：#include 与 #define

C 语言预处理器是一个在你的程序正式编译之前运行的工具。它的工作原理非常简单：文本替换。它不懂得 C 语言的语法，只负责根据指令处理文本。掌握 #include 和 #define 是编写整洁、可维护 C 代码的第一步。

一、 理解 #include：文件粘贴

#include 指令的作用是“把另一个文件的内容完整地复制粘贴过来”。这让你可以将代码拆分到不同的文件中，以便管理。

1. 区分两种语法格式

虽然它们的目的都是引入文件，但搜索路径的优先级不同。

2. 实操：创建并引用自定义头文件

打开你的代码编辑器，创建一个名为 utils.h 的文件。

输入以下代码并保存：

// utils.h
int add(int a, int b) {
    return a + b;
}

创建另一个名为 main.c 的文件。

输入以下代码，使用 #include 指令：

// main.c
#include "utils.h"

int main() {
    int result = add(10, 20);
    return 0;
}

编译并运行 main.c。预处理器会在编译前把 utils.h 里的代码复制到 main.c 的顶部，因此编译器能看到 add 函数的定义。

二、 理解 #define：宏定义与替换

#define 指令用于定义“宏”。预处理器会在代码中找到你定义的名字，并将其替换为你指定的值或代码片段。这就是所谓的“宏替换”。

1. 定义常量

使用 #define 可以给魔法数字起个名字，提高代码可读性。

编写如下代码：

#define PI 3.14159
#define MAX_STUDENTS 100

int main() {
    double area = PI * 5 * 5;
    int class_size = MAX_STUDENTS;
    return 0;
}

注意：预处理器处理后的代码中，所有的 PI 都会变成 3.14159，所有的 MAX_STUDENTS 都会变成 100。宏定义通常习惯用大写字母表示，以区别于普通变量。

2. 定义“类似函数”的宏

宏不仅可以替换数值，还可以接收参数，像函数一样使用，但本质依然是文本替换。

输入以下代码：

#define SQUARE(x) ((x) * (x))

int main() {
    int y = SQUARE(5);
    return 0;
}

观察替换结果。预处理器会将 SQUARE(5) 替换为 ((5) * (5))。

3. 避免宏陷阱：必须加括号

在定义带参数的宏时，切记要对参数和整体表达式都加上括号，否则会出现由于运算优先级导致的错误。

对比以下两种定义方式：

分析：第一种写法因为乘法优先级高于加法，导致计算逻辑完全变了。务必使用第二种写法。

4. 多行宏的定义

如果宏替换的代码很长，跨越多行，使用反斜杠 \ 进行续行。注意 \ 后面不能有任何字符（包括空格或注释），必须直接回车换行。

编写多行宏示例：

#define PRINT_IF even(x) \
    if ((x) % 2 == 0) { \
        printf("Number is even\n"); \
    } else { \
        printf("Number is odd\n"); \
    }

int main() {
    PRINT_IF even(10);
    return 0;
}

三、 预处理器的执行流程

为了让你更清晰地理解代码是如何被处理的，请记住以下顺序：

1. 处理 #include：预处理器读取文件内容，遇到 #include 时，去寻找对应文件并将其内容原封不动地插入到当前文件中，替换掉 #include 这一行。
2. 处理 #define：预处理器从头到尾扫描代码，遇到被定义的宏名字（如 PI 或 SQUARE），就将其替换为定义的文本。
3. 处理条件编译（如 #ifdef）：根据条件决定保留哪部分代码，删除不符合条件的代码。
4. 删除注释：所有的 // 和 /* */ 注释都会被删除。
5. 交给编译器：经过上述处理后的纯文本代码，才会被交给编译器进行语法分析和编译。

运行以下命令查看预处理后的结果（假设文件名为 test.c）：

gcc -E test.c -o test.i

打开生成的 test.i 文件。查看文件底部，你会发现所有的宏都变成了具体的数值或表达式，所有的 #include 都消失了，取而代之的是成千上万行标准库的代码。