头文件卫士通过#ifndef、#define、#endif防止头文件被多次包含，避免类或变量重复定义导致的编译错误；若宏已定义则跳过内容，确保仅首次包含生效。
在C++中，头文件卫士（通常通过 #ifndef、#define 和 #endif 实现）的主要作用是防止头文件被多次包含，从而避免重复定义导致的编译错误。
头文件卫士的基本结构
一个典型的头文件卫士写法如下：
#ifndef MY_HEADER_H #define MY_HEADER_H // 头文件内容：函数声明、类定义、常量等 #endif // MY_HEADER_H
当编译器第一次遇到这个头文件时，MY_HEADER_H 还未定义，因此会执行 #define 并包含其中的内容。如果该头文件被再次包含，#ifndef 会检测到宏已定义，直接跳过整个内容块，防止重复处理。
防止重复定义错误
如果没有头文件卫士，多个源文件包含同一个头文件，或头文件之间互相包含时，很容易出现以下问题：
立即学习“C++免费学习笔记（深入）”；
- 类或结构体被重复定义
- 内联函数或模板多次实例化
- 静态变量或const全局变量重复声明
这些都会引发“redefinition”编译错误。使用头文件卫士后，这些问题可以有效避免。
现代替代方案：#pragma once
除了传统的 #ifndef 方式，大多数现代编译器支持更简洁的写法：
#pragma once // 头文件内容
#pragma once 语义清晰，书写方便，且由编译器保证只包含一次。但它不是C++标准的一部分（尽管广泛支持），在极少数编译器上可能不兼容。因此，在跨平台项目中，仍推荐使用传统的宏卫士方式以确保最大兼容性。
使用建议与注意事项
编写头文件时，应始终添加防护机制。无论使用哪种方式，注意以下几点：
- 宏名称要唯一，通常用头文件名全大写加下划线，如 HEADER_NAME_H
- 确保 #ifndef 和 #define 配对，且位置正确
- 避免在宏名中使用保留标识符（如双下划线或以 _[A-Z] 开头）
- 如果使用模块化C++20，头文件卫士将逐渐被模块取代
基本上就这些。头文件卫士虽小，却是保障项目顺利编译的重要细节。不复杂但容易忽略。
