C/C++ 头文件防卫：告别重复定义错误，把握 #include Guards 与 #pragma once

资料合集下载链接：
​​https://pan.quark.cn/s/472bbdfcd014​​
在 C/C++ 项目开发中，随着文件数量的增加和模块之间依赖关系的复杂化，我们常常会碰到一个令人头疼的题目：头文件重复包罗。当同一个头文件的内容被多次复制到一个编译单元（通常是一个 ​​.c​​​ 或 ​​.cpp​​ 文件颠末预处理处罚后的结果）中时，假如头文件中包罗了变量定义、结构体定义、枚举定义等，就会导致编译器报告重复定义的错误。
这种情况不仅可能发生在直接多次 ​​#include​​ 同一个头文件时，更常见的是通过嵌套包罗引发。比方，​​main.c​​​ 包罗了 ​​headerA.h​​​ 和 ​​headerB.h​​​，而 ​​headerA.h​​​ 内部又包罗了 ​​headerB.h​​​。在预处理处罚阶段，​​headerB.h​​​ 的内容就会被复制到 ​​main.c​​​ 中两次：一次是 ​​main.c​​​ 直接包罗它，另一次是通过 ​​headerA.h​​ 间接包罗。
为了解决这个题目，我们必要一种机制来确保每个头文件在同一个编译单元中只被处理处罚一次。荣幸的是，C/C++ 提供了两种重要的预处理处罚指令来实现这一目的：Include Guards (​​#ifndef​​​ / ​​#define​​​ / ​​#endif​​​) 和 ​​#pragma once​​。
1. 为什么重复包罗是题目？

理解为什么必要防止重复包罗，起首要明确 ​​#include​​​ 指令的工作原理。​​#include​​ 本质上是一个简单的文本更换指令。当预处理处罚器碰到 ​​#include "some_header.h"​​​ 时，它会找到 ​​some_header.h​​​ 文件，然后将其全部内容复制到 ​​#include​​ 指令地点的位置。
考虑一个简单的例子：
​​my_definitions.h​​

1. // my_definitions.h
2. struct Point {
3.     int x;
4.     int y;
5. };

复制代码

​​main.c​​

1. #include "my_definitions.h"
2. #include "my_definitions.h" // 故意重复包含
4. int main() {
5.     struct Point p1 = {10, 20};
6.     return 0;
7. }

复制代码

在编译 ​​main.c​​​ 时，预处理处罚器会先将 ​​my_definitions.h​​​ 的内容复制进来一次，然后再次复制进来。颠末预处理处罚的 ​​main.c​​ 大致会变成如许：

1. struct Point {
2.     int x;
3.     int y;
4. };
6. struct Point { // 第二次复制
7.     int x;
8.     int y;
9. };
11. int main() {
12.     struct Point p1 = {10, 20};
13.     return 0;
14. }

复制代码

现在很明显了，​​struct Point​​ 被定义了两次，这会

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。