重复包含头文件会违反ODR导致重定义错误，需用#pragma once或标准include guard防护；前者非标准且有路径依赖风险，后者需确保宏名唯一，推荐按路径生成宏名并置于文件开头。
为什么 #include 同一个头文件多次会出问题
不是所有重复包含都会报错，但一旦头文件里定义了类、全局变量或模板，编译器就会报 redefinition 错误。比如在多个 .cpp 文件里都 #include "utils.h"，而 utils.h 里写了 class Logger { ... };，链接前的编译阶段就可能炸：多个翻译单元看到同一份定义，违反 One Definition Rule（ODR）。
预处理器本身不记“这个文件我见过”，它只机械地把文件内容贴进去——所以防重包含必须靠人写规则，不是编译器自动兜底。
#pragma once 能不能直接用
能，而且够用，但有隐性限制：
- 不是 C++ 标准特性，是编译器扩展（GCC/Clang/MSVC 都支持，但某些嵌入式或老工具链可能不认）
- 依赖文件路径和 inode 判断“是不是同一个文件”，遇到符号链接、硬链接、挂载点映射时可能失效
- 对同名不同内容的头文件（比如不同子模块下都有
config.h）无法区分，容易误判
示例：如果项目结构里有 /src/config.h 和 /test/config.h，且两者都被 #include "config.h" 引入，#pragma once 可能只认路径，不认语义，导致其中一个被意外跳过。
立即学习“C++免费学习笔记（深入）”；
标准写法：#ifndef / #define / #endif 怎么写才安全
这是 ISO C++ 标准保证支持的方式，关键在宏名唯一性。常见错误是随手写 #ifndef UTILS_H，结果不同模块都用这名字，照样冲突。
实操建议：
- 宏名按路径生成，比如
PROJECT_SRC_UTILS_H或用全小写+下划线+哈希片段：mylib_utils_v2_h_9a3f - 避免纯数字结尾（有些预处理器对
UTILS_H_1解析不稳定） - 宏名里不要含点号或斜杠（
utils.h→UTILS_H可以，utils.h→UTILS.H不行，点号非法） - 放在头文件最开头，前面不能有任何非注释、非空行内容（否则预处理器可能跳过）
正确示范：
#ifndef MYLIB_CORE_MATH_H
#define MYLIB_CORE_MATH_H
namespace mylib {
constexpr double PI = 3.1415926;
}
#endif // MYLIB_CORE_MATH_H
现代项目要不要混用 #pragma once 和 include guard
没必要，也不推荐。双保险看似稳妥，实际增加维护成本，还可能暴露逻辑矛盾——比如宏名拼错了但 #pragma once 挡住了，问题延后到跨平台编译时才爆发。
选择原则很直接：
- 内部工具链可控（如全用 Clang 14+）、无符号链接需求 → 用
#pragma once，写得快，不易手误 - 要发开源库、支持交叉编译、或对接遗留系统 → 用标准 include guard，宏名按规则生成，别偷懒
- 已有代码混用？别动，除非真遇到 bug。改一处漏十处更麻烦
真正容易被忽略的是：头文件里如果有 #include 其他头文件，那些被包含的文件也得各自防重——防护不是只做在“入口头文件”上，而是每一份独立声明都要自保。
