在学习了C++程序的基本结构之后，我们即将编写自己的头文件（如复数类 complex.h）。但在实际项目中，头文件可能会被多个源文件多次 #include，若不做特殊处理，会导致重复定义，编译报错。

本篇博客的核心任务是掌握一种通用的、专业的头文件保护技巧：防卫式声明，让你写出的头文件能安全地被任意顺序、任意多次包含。

隐患：重复包含头文件会带来什么问题？

在C++项目中，一个头文件可能被多个源文件（.cpp）或其它头文件间接包含。例如：

典型包含场景：

文件 a.h 中定义了一个类 Complex。

文件 b.h 中定义了另一个函数，它需要用到 Complex，因此 #include “a.h”。

文件 main.cpp 既直接 #include “a.h”，又 #include
“b.h”。

这样带来的后果就是重复定义，此时 a.h 被 main.cpp 预处理后包含了两次。编译器看到两次完全相同的 class Complex { … }; 定义，这在C++中属于重复定义（违反单一定义规则 ODR），导致编译错误。

初学者常以为“只要自己只包含一次就够了”，但大型项目头文件之间常有复杂的依赖关系，使用者很难记住正确的包含顺序。防卫式声明正是为了解决这一痛点，让头文件本身具备“防重入”能力，使用者无需担心顺序和次数。
除了重复定义，还有一种更隐蔽的隐患：头文件依赖循环。例如 a.h 包含 b.h，b.h 又包含 a.h，若没有防卫式声明，预处理器会无限递归包含，最终导致编译崩溃。

解决方案：预处理指令与防卫式声明的语法

防卫式声明利用C/C++预处理器（在编译前执行文本替换）的条件编译功能，核心指令如下：

QQ20260726-175110

标准写法模板（以复数头文件 complex.h 为例）

1
2
3
4
5
6
7
8
9
#ifndef __COMPLEX_H__
#define __COMPLEX_H__

// 头文件正文：类定义、函数声明等
class Complex {
    // ...
};

#endif

如何在实际头文件中应用？

将防卫式声明应用到实际头文件中，核心是养成固定的书写模板习惯，每次新建头文件时自动套用。

标识符命名惯例

*不是斜体*

通常使用 __文件名大写_H__ 格式，如 __COMPLEX_H__，确保全局唯一。