头文件重复包含会导致预处理阶段报重定义错误；需用#ifndef/#define/#endif或#pragma once防护，前者兼容但易出错，后者简洁安全但非标准且在符号链接等场景可能失效。
为什么头文件重复包含会出问题
当多个源文件或同一源文件中多次 #include 同一个头文件时，若头文件里定义了类、函数声明、宏或 const 变量，编译器会报错：比如 redefinition of 'XXX' 或 multiple definition。这不是链接阶段的问题，而是预处理阶段就失败了——编译器看到两份一模一样的 class A { ... }; 就直接拒掉。
#ifndef / #define / #endif 的写法和坑点
这是 C/C++ 标准方案，兼容所有编译器，但依赖宏名不冲突。常见错误是宏名太简单（如 __MYHEADER_H__），或忘记写 #endif，或宏名拼错导致失效。
正确写法必须满足三点：
- 宏名应基于头文件完整路径做唯一化（常用全大写 + 下划线 + 文件名 + 扩展名，例如
UTILS_STRING_UTILS_H） -
#ifndef和#define必须紧挨着，中间不能有空行或注释（某些旧预处理器会跳过） - 宏名在当前项目中全局唯一；若头文件被不同路径
#include（如"../inc/a.h"和"inc/a.h"），可能绕过保护
#ifndef UTILS_STRING_UTILS_H #define UTILS_STRING_UTILS_H #includestd::string trim(const std::string& s); #endif // UTILS_STRING_UTILS_H
#pragma once 是否更安全
它由编译器直接识别，按文件物理路径去重，不依赖宏名，写起来简洁，且能避免宏名冲突、路径别名等问题。但不是 ISO C++ 标准，不过 GCC 4.7+、Clang、MSVC 全都支持，实际项目中基本可放心用。
立即学习“C++免费学习笔记（深入）”；
需要注意的边界情况：
- 符号链接（symlink）下，GCC/Clang 可能将不同路径指向同一文件视为不同文件，
#pragma once失效；#ifndef因宏名相同仍有效 - 网络文件系统（如 NFS）或某些构建系统中，文件 inode 信息不可靠，
#pragma once可能误判 - 极少数嵌入式工具链（如某些 TI C++ 编译器）不支持
#pragma once #includestruct Config { int timeout; };
该选哪个？混合用有没有问题
现代项目优先用 #pragma once，除非你明确要支持古董级编译器或遇到 symlink/NFS 问题。不要混用：#pragma once + #ifndef 套一层看似“更保险”，实则多余，还可能因宏污染引发奇怪行为（比如某个头文件里 #undef 了你的保护宏）。
真正容易被忽略的是：第三方头文件是否已自带保护？查一下它的开头就知道。如果没加，你自己的头文件又 #include 它，那你也得为它补一层防护——但这通常意味着该库太老，最好推动升级。
