pragma once 和 #ifndef 都用于防止头文件重复包含，前者由编译器通过文件唯一标识实现，效率高但非标准，后者是标准宏守卫，依赖唯一宏名，可移植性好但需手动管理命名以避免冲突。
#pragma once 和 #ifndef（即头文件守卫）都是用来防止头文件被多次包含的机制，它们的目的相同：避免重复定义导致的编译错误。但两者在实现方式、兼容性、行为细节上存在差异。
1. 实现机制不同
• #pragma once 是一种非标准但被广泛支持的预处理指令，由编译器保证该文件在整个编译过程中只被包含一次。编译器通过文件路径或 inode 等唯一标识来判断是否已包含。• #ifndef / #define / #endif 是传统的宏守卫方式，依赖预处理器手动定义宏来防止重复包含。例如：
#ifndef MY_HEADER_H #define MY_HEADER_H // 头文件内容 #endif
2. 兼容性与标准化
• #pragma once 不是 C++ 标准的一部分，但主流编译器（如 MSVC、GCC、Clang）都支持。在极少数或老旧编译器中可能不被识别。• #ifndef 守护宏 是标准 C/C++ 的一部分，任何符合标准的预处理器都能正确处理，具有最好的可移植性。
3. 可靠性与潜在问题
• #pragma once 在某些特殊情况下可能失效，比如同一文件通过不同路径被引用（符号链接、硬链接、相对路径差异），可能导致编译器误判为两个不同的文件。• #ifndef 宏守卫 依赖宏名称的唯一性。如果多个头文件使用了相同的宏名（如不小心都用了
HEADER_H），会导致一个头文件屏蔽另一个，引发难以发现的错误。• 手动命名宏时建议使用项目前缀和唯一名称，例如：
MYPROJECT_MATH_UTILS_H。
4. 编辑器与性能表现
• #pragma once 通常效率更高，因为编译器在打开文件前就能判断是否需要处理，避免重复读取和宏展开。• #ifndef 守护宏 需要预处理器读取整个文件内容，直到遇到
#endif 才能确定跳过，对大文件略慢。• 现代编译器对两者优化良好，实际性能差距通常可以忽略。
基本上就这些。虽然 #pragma once 更简洁且高效，#ifndef 更标准且可控，实际开发中两者常结合使用或根据团队规范选择。许多项目为了保险，甚至同时使用两种方式（虽无必要）。推荐优先使用 #pragma once 并确保文件名和路径唯一，或统一采用规范化的宏守卫命名策略。
