头文件重复包含指同一头文件被多次包含导致编译错误，可用#pragma once或#ifndef宏卫士防护；前者简洁高效但非标准，后者标准兼容但易出错；现代项目优先选#pragma once，严格兼容场景用#ifndef。
在C++中，头文件重复包含会导致编译错误（如重定义、多重声明）或链接问题。避免重复包含主要有两种标准方式：#pragma once 和传统的 #ifndef 宏卫士（include guards），它们作用相同但机制和兼容性不同。
什么是头文件重复包含？
当一个头文件被多个源文件直接或间接包含多次时，若没有防护措施，其内容（如类定义、函数声明、宏等）就会被多次展开，引发编译器报错。例如：A.h 被 B.cpp 和 C.cpp 同时包含，而 B.cpp 又通过 C.h 二次引入了 A.h —— 这就容易触发重复包含。
#pragma once 的用法与特点
#pragma once 是编译器指令，写在头文件最开头，告诉编译器“该文件只被包含一次”。它简洁、易读、不易出错。
- 只需一行：
#pragma once，无需命名、无配对要求 - 由主流编译器（MSVC、Clang、GCC 以来较新版本）原生支持，效率略高（基于文件路径判断）
- 不依赖宏名，避免宏名冲突或拼写错误
- 缺点：非C++标准特性，极少数老旧或嵌入式编译器可能不支持；对硬链接/符号链接处理存在个别差异
#ifndef 宏卫士的标准写法
这是ISO C++标准支持的方式，通过预处理器宏控制是否跳过内容：
立即学习“C++免费学习笔记（深入）”；
#ifndef MY_HEADER_H #define MY_HEADER_H // 头文件主体内容（类、函数声明等） #endif // MY_HEADER_H
- 宏名一般用大写+下划线，按惯例基于文件名（如
STRING_UTILS_H），确保全局唯一 - 必须严格配对：
#ifndef/#define/#endif，且宏名前后一致 - 完全可移植，所有符合标准的编译器都支持
- 风险点：宏名重复（尤其大型项目）、忘记
#define或拼错宏名，会导致失效
怎么选？实用建议
现代项目推荐优先使用 #pragma once，尤其在团队统一使用 Clang/GCC/MSVC 的场景下。它更安全、更简洁、更难误用。
- 若需100%标准兼容（如提交到开源库、支持极端老旧工具链），用
#ifndef更稳妥 - 不必两者共存——混用不会出错，但无必要，反而增加冗余
- 注意：二者都**不能防止头文件内容本身的重复定义**（比如在头文件里写函数实现），这类问题需靠
inline、static或分离声明/定义来解决
不复杂但容易忽略——加一句防护，省去大量编译报错排查时间。
