优先推荐#pragma once，因其简洁高效且主流编译器均支持；若需100%标准兼容或面向小众编译器，则选用#ifndef宏卫士。
在C++项目中，头文件重复包含会导致编译错误（比如类重定义、符号重复声明等），解决方法主要有两种：传统宏卫士 #ifndef 和现代编译器扩展 #pragma once。选哪个？关键看可移植性与编译效率的权衡。
什么是头文件重复包含？
当多个源文件或头文件间接包含同一个头文件时，若没做防护，该头文件内容会被多次展开。例如：A.h 被 B.h 和 C.cpp 同时包含，而 B.h 也包含了 A.h，C.cpp 又直接包含 A.h，就可能触发重复定义。
#pragma once：简洁高效，但非标准
#pragma once 是编译器指令，告诉编译器“这个文件只展开一次”。它由主流编译器（MSVC、GCC 3.4+、Clang）支持，写法简单，无命名冲突风险，且通常比宏卫士略快（编译器可直接按文件路径去重）。
- 放在头文件最开头，一行即可：
#pragma once - 不依赖宏名，不怕拼错或重名
- 对符号链接、硬链接或不同路径指向同一文件的处理，部分旧版编译器可能不一致
- 不符合C++标准，极端跨平台场景（如某些嵌入式专有编译器）可能不支持
#ifndef 宏卫士：标准可靠，需规范命名
这是ISO C++标准方案，用预处理器宏控制展开逻辑：
立即学习“C++免费学习笔记（深入）”；
#ifndef MYPROJECT_UTILS_H #define MYPROJECT_UTILS_H // 头文件正文 #endif // MYPROJECT_UTILS_H
关键点：
- 宏名必须全局唯一，推荐格式：
项目名_路径_文件名_H（全大写+下划线，避免冲突） - 注意命名别太短（如
UTILS_H易撞名），也别含特殊字符或点号（utils.h→ 不合法） - 末尾注释
// MYPROJECT_UTILS_H提高可读性，非必需但强烈建议 - 即使宏名写错（如漏了
#define），也不会报错，而是失效——静默失败，调试困难
工程实践中怎么选？
多数现代项目可放心用 #pragma once，尤其团队统一使用 Clang/GCC/MSVC 时。若需100%标准兼容（如开源库面向小众编译器）、或公司规范强制要求，则坚持 #ifndef。
- 混合使用不推荐：一个文件里同时写两者，冗余且无实质收益
- 头文件必须以防护机制开头，哪怕只有几行声明
- cpp 文件不用加防护（本来就不该被 #include）
- 用构建工具（如 CMake）配合
include_directories控制搜索路径，比靠防护机制“兜底”更健康
基本上就这些。不复杂但容易忽略，养成习惯比事后调试省心多了。
