一、预处理基础：C语言编译流程

很多初学者写C代码，以为写完保存、点一下编译就完事了。其实编译器在背后做了四件事：预处理、编译、汇编、链接。今天我们就从预处理开始聊起。

1.1 编译的四个阶段

我刚开始做嵌入式开发时，也搞不清这四步到底干了啥。直到有一次在STM32项目里，一个宏定义死活不生效，我才老老实实去看了预处理的输出文件。嗯，从那以后我再也不敢跳过预处理这一步了。

简单来说，四个阶段是这样的：

阶段	输入	输出	干了什么
预处理	.c 源文件	.i 预处理文件	处理 #include、#define、条件编译等
编译	.i 文件	.s 汇编文件	将C代码翻译成汇编指令
汇编	.s 文件	.o 目标文件	将汇编指令转成机器码
链接	.o 文件 + 库文件	.elf / .hex 可执行文件	合并目标文件，解析符号地址

你可以用 gcc 的 -E 选项单独看预处理结果：

gcc -E main.c -o main.i

打开 main.i 看看，你会发现所有 #include 的内容都被展开了，宏也被替换了。这个文件往往比源文件大好几倍——我第一次看到时吓了一跳。

1.2 预处理器的角色与功能

预处理器说白了就是一个文本替换工具。它不关心C语法，只认以 # 开头的指令。它的主要工作有三件：

• 文件包含：把 #include 指定的文件内容复制进来
• 宏展开：把 #define 定义的宏替换成对应的文本
• 条件编译：根据 #if / #ifdef / #ifndef 决定哪些代码保留

我个人习惯把预处理器想象成一个「高级的复制粘贴工具」。它不聪明，但很听话。你让它做什么它就做什么，哪怕你写了一个有问题的宏，它也会忠实地展开——然后编译器再给你报错。

1.3 #include 指令详解

#include 是预处理阶段最常用的指令。它的作用就是把另一个文件的内容「粘贴」到当前位置。但这里有个细节：#include <> 和 #include "" 的搜索路径不一样。

1.3.1 #include <stdio.h> —— 尖括号

尖括号告诉预处理器：去系统标准路径找这个头文件。在Linux上通常是 /usr/include，在Windows上一般是编译器安装目录下的 include 文件夹。

我遇到过一个问题：自己写了一个头文件叫 my_uart.h，放在项目目录里，结果用 #include <my_uart.h> 死活找不到。后来才意识到，尖括号只搜系统路径，不搜当前目录。

1.3.2 #include "my_header.h" —— 双引号

双引号会先搜索当前源文件所在的目录，如果找不到，再退回到系统路径去搜。所以自己写的头文件，一定要用双引号。

举个例子：

// 正确用法
#include "uart_driver.h"   // 项目自己的头文件
#include <string.h>        // 标准库头文件

// 错误用法
#include <uart_driver.h>   // 可能找不到！
#include "string.h"        // 也能找到，但不规范

1.4 知识体系图

下面这张图把编译流程和预处理的核心关系画出来了。我画图时习惯把预处理单独拎出来，因为它确实是最容易被忽略的一环。

1.5 避坑指南

我在项目中遇到过几个跟预处理相关的坑，分享给你：

嗯，预处理看起来简单，但用不好确实会出各种奇怪的问题。我的建议是：多看看预处理后的 .i 文件，你就能理解预处理器到底干了什么。

---