头文件守卫通过#ifndef、#define和#endif防止重复包含，避免类或函数重复定义导致编译错误。第一次包含时宏未定义，进入并定义宏；再次包含时因宏已存在而跳过内容。命名应唯一，如使用大写文件名加前缀。#pragma once功能类似但非标准，而宏守卫兼容性更好，是确保头文件只被处理一次的标准做法。
在C++中，头文件里的#ifndef、#define和#endif组合使用，是为了防止头文件被重复包含。这种机制通常被称为“**头文件守卫（Header Guard）**”或“**宏守卫（Include Guard）**”。
为什么需要防止头文件重复包含？
当一个头文件被多个源文件包含，或者由于间接包含（例如A包含B，B又包含C，而A也直接包含C）导致同一个头文件被多次引入时，编译器会多次处理该头文件的内容。如果没有保护机制，可能会出现：
- 类、结构体被重复定义 —— 编译报错“redefinition”
- 函数声明重复 —— 可能引发多重定义问题
- 变量声明冲突 —— 特别是全局变量或内联函数
这些问题会导致编译失败。因此，必须确保头文件的内容在整个编译单元中只被处理一次。
头文件守卫的工作原理
通过预处理器指令实现逻辑判断：如果某个宏尚未定义，则允许编译内容，并立即定义该宏；若已定义，则跳过整个头文件内容。
立即学习“C++免费学习笔记（深入）”；
#ifndef MY_HEADER_H#define MY_HEADER_H
// 头文件的实际内容
class MyClass {
public:
void doSomething();
};
#endif // MY_HEADER_H
上面代码的执行流程如下：
- 第一次包含时，MY_HEADER_H 还未定义，所以 #ifndef 条件成立，进入块内
- 执行 #define MY_HEADER_H，定义宏
- 编译类定义等内容
- 遇到 #endif 结束
- 第二次再包含此文件时，MY_HEADER_H 已存在，条件不成立，直接跳到 #endif 后面，内容被跳过
这样就保证了头文件内容只会被编译一次。
命名规范建议
为避免宏名冲突，守卫宏的名称应具有唯一性。常见做法是使用头文件名的大写形式，并加上项目前缀或路径信息：
- #ifndef UTILS_CONFIG_H
- #ifndef PROJECT_MATH_VECTOR_H
- 也可以用随机后缀如：#ifndef HEADER_FILE_V2_
现代C++还支持一种更简洁的方式：#pragma once，它也能达到相同效果，但它是非标准但广泛支持的扩展。相比之下，#ifndef/#define/#endif 是标准C++的一部分，兼容性更好。
基本上就这些。使用头文件守卫是良好编程习惯的重要部分，能有效避免因重复包含引发的编译错误。虽然看起来简单，但在大型项目中非常关键。
