28、宏与多文件编程：模块化宏设计、全局宏管理、宏命名规范
多文件编程，说白了就是工程大了以后，代码不能全塞在一个文件里。这时候宏怎么管，就成了一个很现实的问题。我见过不少项目，宏定义散落在各个.c文件里，改一个全局配置要翻遍整个工程——嗯，这种苦头我吃过。
今天我们就聊聊，在多文件环境下，怎么把宏管得井井有条。
模块化宏设计：每个模块管好自己的宏
模块化宏设计的核心思想很简单：每个模块只暴露必要的宏，内部使用的宏藏在模块内部。这跟C语言的信息隐藏原则是一脉相承的。
我个人习惯的做法是：
- 模块内部的宏，定义在.c文件里，用
static语义约束（虽然宏没有static关键字，但通过命名和文件范围来约束） - 模块对外接口的宏，定义在对应的.h文件里
- 全局共享的宏，集中到一个专门的
global_defs.h里
举个例子，假设我们有一个LED驱动模块：
// led_driver.h — 对外暴露的宏
#ifndef LED_DRIVER_H
#define LED_DRIVER_H
#define LED_MAX_CHANNELS 8
#define LED_DEFAULT_BRIGHT 100
// 对外接口
void led_init(void);
void led_set_brightness(uint8_t ch, uint8_t val);
#endif// led_driver.c — 内部使用的宏
#define LED_TIMER_PERIOD_MS 10
#define LED_PWM_RESOLUTION 256
#define LED_DEBOUNCE_CNT 3
// 这些宏只在当前.c文件里用
// 其他模块根本不需要知道它们的存在_internal.h头文件。文件名加下划线前缀，一看就知道是内部使用的。
全局宏管理：别让宏满天飞
全局宏管理，最怕的就是「宏污染」。你想想看，一个工程几百个文件，如果每个头文件都定义一堆宏，最后编译的时候宏互相覆盖、冲突，查错能查到崩溃。
我建议的做法是分层管理：
| 层级 | 文件 | 内容 | 示例 |
|---|---|---|---|
| 全局层 | global_defs.h |
系统级常量、版本号、平台宏 | #define SYS_CLOCK_HZ 72000000 |
| 模块层 | xxx_defs.h |
模块对外接口宏、配置选项 | #define UART_BAUD_115200 |
| 文件层 | .c 文件顶部 |
仅当前文件使用的宏 | #define LOCAL_BUFFER_SIZE 64 |
这里有个关键点：全局层的头文件，一定要加多重包含保护。我曾经在一个项目里，因为忘了加#ifndef，结果两个模块同时包含了同一个全局头文件，编译报了一堆重复定义的错——排查了整整一个下午。
main.h或者某个模块的头文件里。否则其他模块为了用这个宏，不得不包含一个不相关的头文件，造成不必要的依赖耦合。
宏命名规范：让名字自己说话
宏命名规范，说白了就是「见名知意」。我见过最离谱的命名是#define A 100，整个文件里到处是A，根本不知道这个100代表什么。
我个人推荐的命名规范如下：
- 全大写 + 下划线分隔：这是C语言的传统，也是共识。比如
LED_MAX_CHANNELS - 模块前缀：每个模块的宏加上统一前缀。比如LED模块用
LED_开头，UART模块用UART_开头 - 功能后缀：常量用
_VAL、标志用_FLAG、掩码用_MASK、默认值用_DEFAULT - 避免通用词：不要用
MAX、MIN、COUNT这种太通用的词，一定要加前缀
来看一个实际例子：
// 好的命名
#define TIMER_PRESCALER_1MS 1000
#define TIMER_FLAG_OVERFLOW 0x01
#define TIMER_DEFAULT_PERIOD_MS 10
// 差的命名
#define PRESCALER 1000 // 哪个模块的？
#define FLAG_OVER 0x01 // 什么标志？
#define DEFAULT_PERIOD 10 // 默认周期？单位呢？核心原则：宏的名字应该让阅读者在不看注释的情况下，就能猜出它的用途、所属模块和数据类型。
多文件编程中的宏避坑指南
这里我总结几个实际项目中踩过的坑：
- 头文件循环包含：A.h包含B.h，B.h又包含A.h。虽然有多重包含保护不会死循环，但会导致宏定义顺序错乱。解决办法是尽量让头文件自包含，不要依赖其他头文件
- 宏定义重复：两个模块定义了同名的宏，后定义的会覆盖先定义的，而且编译器不报错。解决办法是统一前缀管理
- 宏展开后的副作用：比如
#define SQUARE(x) x*x，调用SQUARE(a++)会出问题。解决办法是参数加括号，或者用内联函数替代
我曾经在一个通信协议栈项目里，因为宏命名不规范，导致两个模块都定义了MAX_PACKET_SIZE，一个值是1024，另一个值是512。结果调试了三天才发现是宏被覆盖了——从那以后，我强制团队所有宏必须带模块前缀。
知识体系图
下面这张图总结了宏与多文件编程的核心逻辑：
总结
宏与多文件编程，说到底就是三个字：分、管、规。
- 分：把宏按模块分好，内部的不外露，外部的才暴露
- 管：分层管理，全局的放一处，模块的放一处，文件的放一处
- 规：命名规范统一，前缀后缀清晰，让人一看就懂
做到这三点，你的宏定义就不会成为项目的负担。嗯，我在好几个大型嵌入式项目里验证过这套方法，效果确实不错。
公众号:蓝海资料掘金营，微信deep3321