一、宏定义基础：认识#define、无参宏定义、有参宏定义、宏定义的作用域

各位同学好，我是老周。今天咱们来聊聊C语言里一个特别基础、但又特别容易翻车的话题——宏定义。

说实话，我刚开始学嵌入式那会儿，觉得宏定义不就是个文本替换嘛，有啥好学的？结果呢？第一次做项目，一个宏没加括号，整个程序跑飞了。嗯，从那以后我再也不敢小看它了。

#define 是C语言的预处理指令。说白了，就是在编译器真正干活之前，先把代码里的某些文本替换成另一些文本。它不占内存，不生成代码，就是个纯粹的「查找-替换」工具。

核心要点：宏定义发生在编译的预处理阶段，不是运行时。所以它没有类型检查，也没有作用域的概念（至少传统意义上没有）。

最简单的宏，就是定义一个常量。比如：

#define PI 3.1415926
#define MAX_LEN 128
#define LED_ON 1

我个人习惯，宏名全部大写，单词之间用下划线隔开。这不是语法强制，但几乎是行业共识。你想想看，如果代码里突然冒出个 PI，你一眼就知道它是宏；要是写成 pi，鬼知道是个变量还是宏？

我在项目中遇到过最典型的坑：有人写了 #define BUFFER_SIZE 1024;，注意后面多了个分号！结果用到的地方变成了 int arr[1024;];，编译器直接报错。嗯，宏定义末尾不要加分号，这是新手最容易犯的错误。

避坑指南：我曾经因为宏定义末尾多加分号，排查了整整两个小时。记住：#define 不是语句，不需要分号结尾。

有参宏，看起来像函数，但本质还是文本替换。比如：

#define SQUARE(x) ((x) * (x))
#define MAX(a, b) ((a) > (b) ? (a) : (b))
#define IS_EVEN(x) ((x) % 2 == 0)

注意看，我给每个参数都加了括号，整个表达式也加了括号。为什么？

假设你写了 #define SQUARE(x) x * x，然后调用 SQUARE(3+1)，你期望的是16，对吧？但实际替换后是 3+1 * 3+1，结果是7！

这就是我常说的：有参宏，参数必须加括号，整体必须加括号。少一个都不行。

我的建议：能用函数解决的问题，尽量别用有参宏。宏没有类型检查，调试时看不到宏展开后的代码，出了问题很难排查。只有在追求极致性能（比如频繁调用的小函数）或者需要操作类型（比如泛型）时，才考虑用宏。

这个问题很多人搞不清楚。宏的作用域，其实是从定义位置开始，到文件结束，或者遇到 #undef 为止。

#define DEBUG 1

void func1() {
    // 这里可以使用 DEBUG
}

#undef DEBUG

void func2() {
    // 这里 DEBUG 已经失效了
}

宏没有块作用域的概念。你不能像变量那样，在函数内部定义一个宏，出了函数就自动失效。宏一旦定义，就一路到底，除非你手动 #undef 掉。

我记得有一次，一个同事在头文件里定义了一个叫 size 的宏，结果跟某个结构体的成员变量重名了。整个项目编译报错，找了半天才发现是宏污染了命名空间。嗯，这就是宏的副作用——它不尊重任何作用域规则。

经验之谈：我建议把宏定义集中在头文件的开头，或者专门的配置文件中。尽量不要在函数内部定义宏，也不要在头文件里定义太通用的名字（比如 size、count 这种），很容易跟其他代码冲突。

下面这张图，是我画的知识结构图，帮你理清本章的核心脉络：

说了这么多，总结几条我这些年摸爬滚打出来的经验：

能用 const 就别用宏。 定义常量时，const int MAX = 100; 比 #define MAX 100 更安全，有类型检查，有作用域。
有参宏一定要加括号。 参数加括号，整体加括号，这是铁律。
宏名全大写。 这是约定，也是自我保护。看到全大写的名字，你就知道它是宏，不会误用。
不要滥用宏。 宏虽然方便，但调试困难、没有类型检查、容易污染命名空间。能用函数、枚举、const 解决的问题，优先用它们。

一个小技巧：如果你不确定宏展开后是什么样子，可以用编译器的 -E 选项只做预处理，看看宏展开后的代码。比如 gcc -E test.c，输出就是预处理后的结果。我排查宏问题的时候，这招屡试不爽。

好了，宏定义的基础就讲到这里。下一节咱们聊聊条件编译，那才是宏的真正用武之地。

可可精品资料库