pragma once是一种防止头文件重复包含的预处理指令，通过在文件开头添加该指令，确保编译时只包含一次，相比传统宏守卫更简洁高效，且被主流编译器广泛支持，推荐在现代C++项目中使用。
在C++开发中，头文件被重复包含是一个常见问题。当多个源文件包含同一个头文件，或头文件之间相互嵌套包含时，可能造成类、函数、变量等的重复定义，导致编译错误。#pragma once 是一种简单有效的防止头文件重复包含的预处理指令。
什么是 #pragma once
#pragma once 是一个非标准但被主流编译器广泛支持的预处理指令，用于确保头文件在整个编译过程中只被包含一次。只要编译器遇到这个指令，就会标记该文件，在后续再次尝试包含时自动跳过。
使用方式非常简单，只需在头文件的开头添加一行：
#pragma once例如，一个典型的头文件 MyClass.h 可以这样写：
立即学习“C++免费学习笔记（深入）”；
#pragma once
class MyClass {
public:
void doSomething();
};
与传统宏守卫的对比
在 #pragma once 出现之前，开发者通常使用“包含守卫”（include guards）来防止重复包含：
#ifndef MYCLASS_H
#define MYCLASS_H
class MyClass {
public:
void doSomething();
};
#endif // MYCLASS_H
两者功能相似，但 #pragma once 有以下优势：
- 书写更简洁，无需手动定义宏名，避免命名冲突
- 编译器可直接识别文件路径，效率更高
- 减少人为错误，比如宏名拼写错误或不一致
不过，宏守卫是 C++ 标准支持的，理论上兼容性更好；而 #pragma once 虽然几乎被所有现代编译器（如 GCC、Clang、MSVC）支持，但仍属于实现定义行为。
使用建议
在实际项目中，推荐使用 #pragma once，特别是在新项目中。它清晰、简洁、高效。如果项目需要极端的跨平台兼容性或必须遵循严格的标准规范，可以考虑继续使用宏守卫。
也可以结合两者使用，虽然有些多余，但不影响结果：
#pragma once #ifndef MYCLASS_H #define MYCLASS_H // 内容 #endif
这种做法并无必要，除非团队规范强制要求。
注意事项
尽管 #pragma once 很好用，但也有一些边缘情况需要注意：
- 如果同一个文件通过不同路径被包含（如符号链接或硬链接），某些旧版编译器可能无法正确识别为同一文件
- 在极少数嵌入式或老旧编译器中可能不支持
因此，在关键系统或需要高度可移植的代码中，应评估编译器支持情况。
基本上就这些。#pragma once 让头文件管理变得更轻松，现代C++开发中值得推荐。
