pragma once 是 C++ 中防止头文件重复包含的预处理指令，通过编译器记录文件标识确保只包含一次，相比传统宏保护更简洁高效，主流编译器均支持，推荐在现代项目中使用。
#pragma once 是 C++ 中用于防止头文件被重复包含的一种预处理指令。它比传统的 #ifndef / #define 宏保护更简洁、易读，且由编译器保证唯一性，能有效避免同一头文件在同一个编译单元中被多次引入。
作用与原理
当一个头文件被多个源文件或嵌套包含时，可能会导致类型重定义、函数重复声明等编译错误。#pragma once 告诉编译器：该文件在当前编译过程中只应被包含一次。
编译器在第一次处理该文件后，会记录其路径或标识，再次遇到时自动跳过内容加载，从而实现防重包含。
基本用法
只需在头文件的最开始位置添加一行：
立即学习“C++免费学习笔记（深入）”；
#pragma once例如，创建一个名为 MyClass.h 的头文件：
#pragma once class MyClass { public: void doSomething(); };这样，无论你在多少个 .cpp 文件中包含它，或者通过其他头文件间接包含，都不会出现重复包含问题。
与传统宏保护对比
传统方式使用宏定义防止重复包含：
#ifndef MYCLASS_H #define MYCLASS_H // 内容 #endif // MYCLASS_H
相比而言，#pragma once 优势明显：
- 写法简单，无需手动定义唯一宏名
- 避免宏命名冲突
- 编译器可优化识别，效率更高
- 减少出错概率（如宏名拼写错误）
但注意：#pragma once 不是 C++ 标准的一部分，而是广泛支持的编译器扩展。主流编译器（MSVC、GCC、Clang）都支持，但在极少数或老旧编译器上可能不兼容。
使用建议
现代 C++ 项目推荐使用 #pragma once，尤其在新工程中。若需最大兼容性（如跨平台库、需支持古老工具链），可继续使用宏保护或两者共存。
常见安全写法（兼顾兼容性和清晰性）：
#pragma once #ifndef MYCLASS_H #define MYCLASS_H // 头文件内容 #endif // MYCLASS_H不过一般情况下，单独使用 #pragma once 已足够可靠。
基本上就这些。只要记住把它放在头文件第一行（在包含其他内容之前），就能轻松避免重复包含问题。
