使用头文件保护宏或#pragma once可防止C++头文件重复包含。前者通过#ifndef、#define和#endif定义唯一宏来避免重复编入，兼容性好；后者为编译器指令，写法简洁且高效，但非ISO标准。推荐根据项目需求选择：注重可移植性时用保护宏，现代开发中多用#pragma once。
在C++开发中，头文件被重复包含是一个常见问题。如果一个头文件被多次包含到同一个编译单元中，可能导致类、函数或变量的重复定义，从而引发编译错误。为了解决这个问题，通常有两种主流方法：使用头文件保护宏（include guards）和 #pragma once 指令。
头文件保护宏（Include Guards）
这是传统的、可移植性强的方法，通过预处理器指令防止头文件内容被多次处理。
基本写法如下：
#ifndef MY_HEADER_H
#define MY_HEADER_H
// 头文件内容
class MyClass {
// ...
};
#endif // MY_HEADER_H
说明：
立即学习“C++免费学习笔记（深入）”；
- #ifndef 判断某个宏是否未定义。如果未定义，则继续执行下面的内容。
- #define 定义一个唯一的宏名，通常根据项目和文件命名规则来命名，避免冲突。
- 当该头文件第一次被包含时，宏未定义，因此会定义宏并包含内容；第二次及以后再包含时，宏已定义，#ifndef 条件为假，整个头文件内容被跳过。
优点：
- 兼容所有标准C++编译器。
- 符合ISO C++标准，可移植性好。
注意事项：
- 宏名称必须唯一，建议使用全大写、下划线分隔，并包含项目或文件信息，例如：GRAPHICS_CAMERA_H。
- 避免使用保留标识符（如双下划线或以_开头后接大写字母）。
#pragma once 的用法
这是一种非标准但被广泛支持的简化方式，告诉编译器只允许该头文件被包含一次。
#pragma once
// 头文件内容
class Utility {
// ...
};
说明：
立即学习“C++免费学习笔记（深入）”；
- #pragma once 是编译器指令，由大多数现代编译器（如GCC、Clang、MSVC）支持。
- 无需手动定义宏，更简洁，也减少了命名冲突的风险。
优点：
- 写法简单，不易出错。
- 编译器可优化处理，有时比宏判断更快。
缺点：
- 不是C++标准的一部分，理论上存在可移植性风险（尽管实际中极少遇到不支持的情况）。
- 在某些特殊情况下（如硬链接或符号链接指向同一文件），可能判断失效。
两种方式如何选择？
目前主流做法是：
- 在个人项目或现代开发环境中，推荐使用 #pragma once，简洁清晰。
- 在需要最大可移植性或参与开源项目时，使用传统 include guards 更稳妥。
- 有些人会同时使用两者作为“双重保险”，但这通常没有必要。
示例混合写法（少见但安全）：
#pragma once #ifndef UTILITY_H #define UTILITY_H // 内容 #endif
基本上就这些。无论选择哪种方式，关键是确保每个头文件都有防重包含机制。#pragma once 更现代便捷，而 include guards 更标准可靠。根据团队规范和项目需求选择即可。
