头文件保护

检查是否已经定义了一个特定的宏：使用 #ifndef 指令检查是否已经定义了一个特定的宏（通常是头文件的名称或一个唯一的标识符）。
定义该宏：如果该宏尚未定义，则使用 #define 指令定义它，并包含头文件的内容。
结束条件编译块：使用 #endif 指令结束条件编译块。

通过使用头文件保护，可以有效地管理头文件的包含关系

头文件保护通常使用预处理器指令 #ifndef、#define 和 #endif 来实现。

良好的头文件设计比单纯依赖保护机制更能提升代码质量和编译效率

推荐优先使用#pragma once，并在需要兼容老旧环境时回退到#ifndef。

首次包含时，因宏未定义而执行头文件内容并定义宏；后续包含时，由于宏已存在，预处理器跳过内容

头文件保护是C/C++开发的基础实践

减少编译器对相同代码的重复处理次数，缩短编译时间

头文件保护使用的宏名称应该具有唯一性，以避免与其他头文件或项目中其他部分的宏名称冲突。通常使用头文件的名称加上 _H 后缀

当多个源文件（.c/.cpp）包含同一个头文件（.h），或头文件之间存在循环包含（如 A.h 包含 B.h，B.h 又包含 A.h）时，编译器会多次解析同一个头文件

头文件中尽量只包含必要的声明，减少传递包含。

通过使用预处理指令（如#ifndef、#define和#endif）来确保头文件的内容只被编译一次，从而避免重复定义和编译错误。

传统宏保护中，宏名需全局唯一，推荐结合项目/模块前缀