pragma once 与 #ifndef 均用于防止头文件重复包含，前者由编译器保证唯一性，后者通过宏定义实现；#pragma once 更高效简洁但依赖编译器支持，#ifndef 可移植性强但需手动管理宏名避免冲突。
#pragma once 和 #ifndef（配合 #define、#endif 使用）都是用来防止头文件被重复包含的机制，它们的目的相同：避免同一个头文件在同一个编译单元中被多次处理，从而导致重复定义错误。虽然功能相似，但两者在实现方式、兼容性、效率和使用习惯上存在一些关键区别。
1. 实现机制不同
#pragma once 是一种由编译器提供的非标准但广泛支持的指令，告诉编译器该头文件只允许被包含一次。编译器在遇到这个指令时，会记录该文件的路径或唯一标识，后续再次包含同一文件时自动跳过。
#ifndef / #define / #endif 是基于宏定义的传统预处理方法。通过检查某个宏是否已定义来判断头文件是否已被包含。例如：
#ifndef MY_HEADER_H #define MY_HEADER_H // 头文件内容 #endif // MY_HEADER_H
首次包含时，MY_HEADER_H 未定义，条件成立，头文件内容被处理并定义宏；再次包含时，宏已存在，内容被跳过。
立即学习“C++免费学习笔记（深入）”；
2. 兼容性差异
- #pragma once：不是 C++ 标准的一部分，但几乎所有主流编译器（如 MSVC、GCC、Clang）都支持。理论上在某些小众或老旧编译器上可能不被识别。
- #ifndef 方式：完全基于标准 C/C++ 预处理器，具有最高可移植性，在任何符合标准的编译器上都能正常工作。
3. 性能表现
- #pragma once：编译器可以直接通过文件系统信息（如 inode 或路径）判断是否已包含，无需解析整个文件，因此通常更快，尤其是在大型项目中减少 I/O 开销。
- #ifndef：预处理器必须读取文件内容，逐行处理直到遇到对应的 #endif，才能确定是否跳过。即使文件已被包含，仍需打开和扫描文件头部部分。
4. 使用注意事项与潜在问题
#pragma once 的局限性：
- 依赖文件路径唯一性。如果同一文件通过不同路径（如符号链接、硬链接）被包含，某些编译器可能无法识别为同一文件，导致保护失效或误判。
- 网络文件系统或特殊挂载方式下可能影响判断准确性。
#ifndef 的常见问题：
- 宏命名冲突风险。若多个头文件使用相同的守卫宏名，可能导致一个头文件被错误地屏蔽。应使用唯一命名（如 _PROJECT_MODULE_FILENAME_H）。
- 手动维护宏名称，容易出错（如拼写错误、遗漏 #endif）。
5. 实际使用建议
- 现代 C++ 项目中，#pragma once 因其简洁性和性能优势被广泛采用，尤其在 Visual Studio、Clang 和 GCC 环境下推荐使用。
- 对可移植性要求极高的库（如开源跨平台库），可优先使用传统的 #ifndef 守护方式，确保在所有环境下稳定工作。
- 也可以结合使用（虽然没必要）：多数编译器会优化重复保护，但不推荐冗余写法。
基本上就这些。两者都能有效防止头文件重复包含，选择哪一个主要取决于项目需求、编译器支持和团队规范。#pragma once 更现代、简洁、高效；#ifndef 更标准、可控、兼容性强。根据实际情况合理选用即可。
