ifndef 和 #pragma once 均可防止头文件重复包含，但机制不同：前者依赖唯一宏名、符合标准、兼容性好；后者依赖文件路径、非标准但高效，存在符号链接等边缘问题。
用 #ifndef 或 #pragma once 都能防止头文件重复包含，但它们机制不同、兼容性不同、行为边界也不同——选错可能在跨平台或复杂构建中出问题。
为什么重复包含头文件会出错
多次定义同一类、函数声明、宏，会导致编译器报 redefinition 错误；即使只是声明，某些模板或内联函数也可能因 ODR（One Definition Rule）违规而链接失败。
常见触发场景：
- 多个源文件都
#include "common.h" -
A.h包含B.h，而main.cpp同时#include "A.h"和"B.h" - 循环包含（如
A.h→B.h→A.h），没加防护直接崩溃
#ifndef 是标准、可控、但啰嗦的方案
它依赖预处理器宏名唯一性，属于 C/C++ 标准规定行为，所有编译器都支持。
典型写法：
#ifndef MY_HEADER_H #define MY_HEADER_H // 头文件内容 #endif // MY_HEADER_H
关键点：
- 宏名
MY_HEADER_H必须全局唯一，建议用路径+文件名大写+下划线组合，比如UTILS_STRING_UTILS_H - 不能放在头文件最开头之前（比如前面有注释或
#pragma once），否则宏可能失效 - 如果两个头文件意外用了相同宏名（如都叫
COMMON_H），其中一个会被静默跳过——这种 bug 很难排查 - 支持条件嵌套：可在
#ifndef内再做#ifdef _WIN32等判断
#pragma once 是简洁、高效、但非标准的替代方案
它由编译器直接识别文件路径，只要物理文件相同就只展开一次，不依赖宏名，也不怕命名冲突。
写法简单：
#pragma once // 头文件内容
优势与风险并存：
- 速度快：编译器可直接查 inode 或路径哈希，比宏展开+字符串比较更快（尤其大型项目）
- 不会因宏名重复失效，对 IDE 重命名/符号跳转更友好
- 但不是 ISO C++ 标准，虽被 GCC、Clang、MSVC 广泛支持，仍存在边缘情况：
– 符号链接或硬链接下，不同路径指向同一文件，部分旧版编译器可能视为两个文件
– 网络文件系统或挂载路径不一致时，路径解析可能出偏差 - 不能和
#ifndef混用在同一头文件里（多数编译器允许，但语义混乱，不推荐）
实际项目怎么选
没有绝对答案，取决于团队约束和构建环境：
- 追求最大兼容性（如嵌入式、交叉编译、老版本 IAR/Keil）→ 只用
#ifndef - 主流桌面/服务端开发（GCC 5+/Clang 3.5+/MSVC 2015+）→
#pragma once更省心，尤其配合现代 CMake 或 Bazel - 开源库或要进第三方 SDK → 推荐
#ifndef，避免下游构建环境意外失败 - 已有项目混用？别强行统一。但新头文件建议固定一种，并在 CI 中用脚本检查风格一致性（例如 grep
^#pragma once+^#ifndef）
真正容易被忽略的是：即便加了防护，若头文件里定义了非 inline 的函数、或未用 extern 声明的全局变量，仍然会链接失败——防护只是防“多次声明”，不解决“多次定义”。
