宏重复被覆盖：同名宏重定义逻辑变，加 #ifndef 守护或改名

宏重复被覆盖：同名宏重定义逻辑变，加 #ifndef 守护或改名

摘要：同名宏在多处 #define 且无守护时，后定义会覆盖先定义，导致"你以为的宏值"与实际不符，逻辑悄悄改变；不同编译单元因包含顺序不同还会出现行为不一致。本文用一个真实翻车现场讲清根因，并给出两种正解：加 #ifndef 守护，或改名加模块前缀从根避免冲突，附完整代码与最佳实践清单。

一、开篇：一个真实翻车现场

代码里 #define BUF_SIZE 64，后来引入一个第三方库/另一个模块，它恰好也 #define BUF_SIZE 128（没任何守护）。预处理时后定义的（或包含顺序决定）覆盖前者，于是我代码里"以为的 BUF_SIZE=64"实际变成 128 → 数组大小、循环边界全变，内存布局和预期不符，出现越界或浪费。

更隐蔽的是：两个 #define BUF_SIZE 在不同头文件，包含顺序不同结果不同 → 同一份代码不同编译单元行为不一致。

根因一句话：同名宏在多处 #define 且无守护，后定义的会覆盖先定义的（或编译器报重定义警告但继续）。导致"你以为的宏值"和实际不符，逻辑悄悄改变。解法：自己的宏加 #ifndef 守护（#ifndef X \\n #define X … \\n #endif），或改名加前缀避免冲突；公共宏集中放头文件。

适用读者：引入库/模块后行为异常，查到最后是某个宏被别处重定义覆盖的同学。
读完你能做：识别同名宏覆盖导致的逻辑变异，用 #ifndef 守护或改名加前缀避免冲突。

二、先搞懂：宏是全局文本替换（认知）

2.1 宏作用域全局

#define 的宏从定义点到翻译单元结束都有效，且没有命名空间。同名宏，后定义的（取决于包含顺序）覆盖前一个。C 标准允许重定义若"完全相同"，否则是未定义/警告。

2.2 为什么难查

宏覆盖不改变语法，只是值变了。行为异常表现为"数组大小不对/边界错"，且不同编译单元因包含顺序不同结果不同 → 极难定位。

#mermaid-svg-3OMLB9zAWBasGAaj{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-3OMLB9zAWBasGAaj .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-3OMLB9zAWBasGAaj .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-3OMLB9zAWBasGAaj .error-icon{fill:#552222;}#mermaid-svg-3OMLB9zAWBasGAaj .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-3OMLB9zAWBasGAaj .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-3OMLB9zAWBasGAaj .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-3OMLB9zAWBasGAaj .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-3OMLB9zAWBasGAaj .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-3OMLB9zAWBasGAaj .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-3OMLB9zAWBasGAaj .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-3OMLB9zAWBasGAaj .marker{fill:#333333;stroke:#333333;}#mermaid-svg-3OMLB9zAWBasGAaj .marker.cross{stroke:#333333;}#mermaid-svg-3OMLB9zAWBasGAaj svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-3OMLB9zAWBasGAaj p{margin:0;}#mermaid-svg-3OMLB9zAWBasGAaj .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-3OMLB9zAWBasGAaj .cluster-label text{fill:#333;}#mermaid-svg-3OMLB9zAWBasGAaj .cluster-label span{color:#333;}#mermaid-svg-3OMLB9zAWBasGAaj .cluster-label span p{background-color:transparent;}#mermaid-svg-3OMLB9zAWBasGAaj .label text,#mermaid-svg-3OMLB9zAWBasGAaj span{fill:#333;color:#333;}#mermaid-svg-3OMLB9zAWBasGAaj .node rect,#mermaid-svg-3OMLB9zAWBasGAaj .node circle,#mermaid-svg-3OMLB9zAWBasGAaj .node ellipse,#mermaid-svg-3OMLB9zAWBasGAaj .node polygon,#mermaid-svg-3OMLB9zAWBasGAaj .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-3OMLB9zAWBasGAaj .rough-node .label text,#mermaid-svg-3OMLB9zAWBasGAaj .node .label text,#mermaid-svg-3OMLB9zAWBasGAaj .image-shape .label,#mermaid-svg-3OMLB9zAWBasGAaj .icon-shape .label{text-anchor:middle;}#mermaid-svg-3OMLB9zAWBasGAaj .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-3OMLB9zAWBasGAaj .rough-node .label,#mermaid-svg-3OMLB9zAWBasGAaj .node .label,#mermaid-svg-3OMLB9zAWBasGAaj .image-shape .label,#mermaid-svg-3OMLB9zAWBasGAaj .icon-shape .label{text-align:center;}#mermaid-svg-3OMLB9zAWBasGAaj .node.clickable{cursor:pointer;}#mermaid-svg-3OMLB9zAWBasGAaj .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-3OMLB9zAWBasGAaj .arrowheadPath{fill:#333333;}#mermaid-svg-3OMLB9zAWBasGAaj .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-3OMLB9zAWBasGAaj .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-3OMLB9zAWBasGAaj .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-3OMLB9zAWBasGAaj .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-3OMLB9zAWBasGAaj .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-3OMLB9zAWBasGAaj .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-3OMLB9zAWBasGAaj .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-3OMLB9zAWBasGAaj .cluster text{fill:#333;}#mermaid-svg-3OMLB9zAWBasGAaj .cluster span{color:#333;}#mermaid-svg-3OMLB9zAWBasGAaj div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-3OMLB9zAWBasGAaj .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-3OMLB9zAWBasGAaj rect.text{fill:none;stroke-width:0;}#mermaid-svg-3OMLB9zAWBasGAaj .icon-shape,#mermaid-svg-3OMLB9zAWBasGAaj .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-3OMLB9zAWBasGAaj .icon-shape p,#mermaid-svg-3OMLB9zAWBasGAaj .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-3OMLB9zAWBasGAaj .icon-shape rect,#mermaid-svg-3OMLB9zAWBasGAaj .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-3OMLB9zAWBasGAaj .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-3OMLB9zAWBasGAaj .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-3OMLB9zAWBasGAaj :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

无

ifndef守护

同名宏多处define

有守护?

后者覆盖 逻辑变

首次定义生效

图 1：宏重定义覆盖（如图 1 所示，无守护即覆盖）。

[注意] 现代编译器对"不相同重定义"会警告甚至错误（取决于 -Werror/标准），但"相同文本重定义"常被放行，隐蔽地允许后定义覆盖（取决于实现）。所以别依赖编译器报错。

三、为什么会变（原理 + 真实错误代码）

3.1 错误版

// 文件 a.h
#define BUF_SIZE 64
// 文件 b.h（第三方）
#define BUF_SIZE 128 // 同名，无守护
// 包含顺序决定最终值，覆盖发生
uint8_t buf[BUF_SIZE]; // 实际可能是 128 而非以为的 64

错：①两处同名 #define 无守护；②包含顺序使 128 覆盖 64；③buf 大小变 128，与预期布局不符 → 越界/错位。

[坑] 铁律：自己的宏加 #ifndef 守护或改名加前缀，避免被同名宏覆盖。公共宏集中管理。

3.2 为什么"不同编译单元不同行为"

包含顺序在不同 .c 里可能不同 → 同一宏值不同 → 行为不一致，极难复现和定位。

下面是不同编译单元行为不一致的示意：

#mermaid-svg-E3csRhTDCpGvPjn9{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-E3csRhTDCpGvPjn9 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-E3csRhTDCpGvPjn9 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-E3csRhTDCpGvPjn9 .error-icon{fill:#552222;}#mermaid-svg-E3csRhTDCpGvPjn9 .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-E3csRhTDCpGvPjn9 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-E3csRhTDCpGvPjn9 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-E3csRhTDCpGvPjn9 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-E3csRhTDCpGvPjn9 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-E3csRhTDCpGvPjn9 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-E3csRhTDCpGvPjn9 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-E3csRhTDCpGvPjn9 .marker{fill:#333333;stroke:#333333;}#mermaid-svg-E3csRhTDCpGvPjn9 .marker.cross{stroke:#333333;}#mermaid-svg-E3csRhTDCpGvPjn9 svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-E3csRhTDCpGvPjn9 p{margin:0;}#mermaid-svg-E3csRhTDCpGvPjn9 .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-E3csRhTDCpGvPjn9 .cluster-label text{fill:#333;}#mermaid-svg-E3csRhTDCpGvPjn9 .cluster-label span{color:#333;}#mermaid-svg-E3csRhTDCpGvPjn9 .cluster-label span p{background-color:transparent;}#mermaid-svg-E3csRhTDCpGvPjn9 .label text,#mermaid-svg-E3csRhTDCpGvPjn9 span{fill:#333;color:#333;}#mermaid-svg-E3csRhTDCpGvPjn9 .node rect,#mermaid-svg-E3csRhTDCpGvPjn9 .node circle,#mermaid-svg-E3csRhTDCpGvPjn9 .node ellipse,#mermaid-svg-E3csRhTDCpGvPjn9 .node polygon,#mermaid-svg-E3csRhTDCpGvPjn9 .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-E3csRhTDCpGvPjn9 .rough-node .label text,#mermaid-svg-E3csRhTDCpGvPjn9 .node .label text,#mermaid-svg-E3csRhTDCpGvPjn9 .image-shape .label,#mermaid-svg-E3csRhTDCpGvPjn9 .icon-shape .label{text-anchor:middle;}#mermaid-svg-E3csRhTDCpGvPjn9 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-E3csRhTDCpGvPjn9 .rough-node .label,#mermaid-svg-E3csRhTDCpGvPjn9 .node .label,#mermaid-svg-E3csRhTDCpGvPjn9 .image-shape .label,#mermaid-svg-E3csRhTDCpGvPjn9 .icon-shape .label{text-align:center;}#mermaid-svg-E3csRhTDCpGvPjn9 .node.clickable{cursor:pointer;}#mermaid-svg-E3csRhTDCpGvPjn9 .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-E3csRhTDCpGvPjn9 .arrowheadPath{fill:#333333;}#mermaid-svg-E3csRhTDCpGvPjn9 .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-E3csRhTDCpGvPjn9 .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-E3csRhTDCpGvPjn9 .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-E3csRhTDCpGvPjn9 .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-E3csRhTDCpGvPjn9 .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-E3csRhTDCpGvPjn9 .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-E3csRhTDCpGvPjn9 .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-E3csRhTDCpGvPjn9 .cluster text{fill:#333;}#mermaid-svg-E3csRhTDCpGvPjn9 .cluster span{color:#333;}#mermaid-svg-E3csRhTDCpGvPjn9 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-E3csRhTDCpGvPjn9 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-E3csRhTDCpGvPjn9 rect.text{fill:none;stroke-width:0;}#mermaid-svg-E3csRhTDCpGvPjn9 .icon-shape,#mermaid-svg-E3csRhTDCpGvPjn9 .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-E3csRhTDCpGvPjn9 .icon-shape p,#mermaid-svg-E3csRhTDCpGvPjn9 .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-E3csRhTDCpGvPjn9 .icon-shape rect,#mermaid-svg-E3csRhTDCpGvPjn9 .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-E3csRhTDCpGvPjn9 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-E3csRhTDCpGvPjn9 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-E3csRhTDCpGvPjn9 :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

同一份源码

编译单元 1（先包含 a.h 后 b.h）

编译单元 2（先包含 b.h 后 a.h）

BUF_SIZE = 128

BUF_SIZE = 64

行为 A

行为 B

结果不一致，极难复现

图 2：包含顺序不同导致同一宏在不同编译单元取值不同。

四、正确解法：#ifndef 守护 / 改名（完整落地）

4.1 方案对比

下面是方案选择的决策流程：

#mermaid-svg-IUt9vXEJt48TsWlX{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-IUt9vXEJt48TsWlX .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-IUt9vXEJt48TsWlX .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-IUt9vXEJt48TsWlX .error-icon{fill:#552222;}#mermaid-svg-IUt9vXEJt48TsWlX .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-IUt9vXEJt48TsWlX .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-IUt9vXEJt48TsWlX .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-IUt9vXEJt48TsWlX .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-IUt9vXEJt48TsWlX .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-IUt9vXEJt48TsWlX .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-IUt9vXEJt48TsWlX .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-IUt9vXEJt48TsWlX .marker{fill:#333333;stroke:#333333;}#mermaid-svg-IUt9vXEJt48TsWlX .marker.cross{stroke:#333333;}#mermaid-svg-IUt9vXEJt48TsWlX svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-IUt9vXEJt48TsWlX p{margin:0;}#mermaid-svg-IUt9vXEJt48TsWlX .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-IUt9vXEJt48TsWlX .cluster-label text{fill:#333;}#mermaid-svg-IUt9vXEJt48TsWlX .cluster-label span{color:#333;}#mermaid-svg-IUt9vXEJt48TsWlX .cluster-label span p{background-color:transparent;}#mermaid-svg-IUt9vXEJt48TsWlX .label text,#mermaid-svg-IUt9vXEJt48TsWlX span{fill:#333;color:#333;}#mermaid-svg-IUt9vXEJt48TsWlX .node rect,#mermaid-svg-IUt9vXEJt48TsWlX .node circle,#mermaid-svg-IUt9vXEJt48TsWlX .node ellipse,#mermaid-svg-IUt9vXEJt48TsWlX .node polygon,#mermaid-svg-IUt9vXEJt48TsWlX .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-IUt9vXEJt48TsWlX .rough-node .label text,#mermaid-svg-IUt9vXEJt48TsWlX .node .label text,#mermaid-svg-IUt9vXEJt48TsWlX .image-shape .label,#mermaid-svg-IUt9vXEJt48TsWlX .icon-shape .label{text-anchor:middle;}#mermaid-svg-IUt9vXEJt48TsWlX .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-IUt9vXEJt48TsWlX .rough-node .label,#mermaid-svg-IUt9vXEJt48TsWlX .node .label,#mermaid-svg-IUt9vXEJt48TsWlX .image-shape .label,#mermaid-svg-IUt9vXEJt48TsWlX .icon-shape .label{text-align:center;}#mermaid-svg-IUt9vXEJt48TsWlX .node.clickable{cursor:pointer;}#mermaid-svg-IUt9vXEJt48TsWlX .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-IUt9vXEJt48TsWlX .arrowheadPath{fill:#333333;}#mermaid-svg-IUt9vXEJt48TsWlX .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-IUt9vXEJt48TsWlX .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-IUt9vXEJt48TsWlX .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-IUt9vXEJt48TsWlX .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-IUt9vXEJt48TsWlX .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-IUt9vXEJt48TsWlX .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-IUt9vXEJt48TsWlX .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-IUt9vXEJt48TsWlX .cluster text{fill:#333;}#mermaid-svg-IUt9vXEJt48TsWlX .cluster span{color:#333;}#mermaid-svg-IUt9vXEJt48TsWlX div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-IUt9vXEJt48TsWlX .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-IUt9vXEJt48TsWlX rect.text{fill:none;stroke-width:0;}#mermaid-svg-IUt9vXEJt48TsWlX .icon-shape,#mermaid-svg-IUt9vXEJt48TsWlX .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-IUt9vXEJt48TsWlX .icon-shape p,#mermaid-svg-IUt9vXEJt48TsWlX .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-IUt9vXEJt48TsWlX .icon-shape rect,#mermaid-svg-IUt9vXEJt48TsWlX .image-shape rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-IUt9vXEJt48TsWlX .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-IUt9vXEJt48TsWlX .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-IUt9vXEJt48TsWlX :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

是

否

发现同名宏冲突

宏是否必须保留原名？

加 #ifndef 守护

改名加模块前缀

首次定义生效，防覆盖

从根上避免冲突

✅ 逻辑稳定

图 3：宏冲突的两种正解选择路径。

4.2 配置（照着点）

开 -Wmacro-redefined（GCC）抓重定义。

4.3 完整代码

// ✅ 正确：守护 + 前缀
#ifndef MYMOD_BUF_SIZE
#define MYMOD_BUF_SIZE 64 // 加模块前缀，防冲突
#endif
uint8_t buf[MYMOD_BUF_SIZE];

// 或用 #pragma once / include guard 保护整个头文件不被重复包含

[坑] 两个翻车点收好：

4.4 改完对比

五、收尾

要点复盘

最佳实践清单

• 所有公共宏加 #ifndef X / #define X / #endif 守护。
• 宏命名加模块前缀（如 MYMOD_），避免通用名冲突。
• 公共宏集中放单一头文件，统一管理。
• 开 -Wmacro-redefined 抓重定义。
• 头文件加 include guard / #pragma once 防重复包含。

进阶延伸：C++ 用 constexpr/enum class 替代宏，有作用域更安全；C 用 static const 替代部分宏避免文本替换副作用。

互动：你宏冲突还踩过啥？第三方库宏冲突、宏展开副作用（第47讲）、条件编译灰显（第79讲）？评论区聊。