pragma once 是 c++ 中用于防止头文件重复包含的预处理指令，通过编译器确保头文件仅被包含一次。相比传统宏守卫 #ifndef/#define/#endif，它语法简洁、避免命名冲突且不易出错，但依赖文件路径唯一性，在多路径或符号链接场景可能失效。现代编译器广泛支持，推荐在新项目中使用以提升代码可读性和维护效率。
#pragma once 是 C++ 中一种用于防止头文件被重复包含的预处理指令。它的主要作用是确保在同一个编译过程中，某个头文件只被编译一次，从而避免因重复定义类、函数或变量而导致的编译错误。
防止头文件重复包含
在大型项目中，多个源文件可能会包含相同的头文件，而这些头文件之间也可能相互引用。如果没有保护机制，就可能出现同一个头文件被多次引入的情况，导致重复定义的问题。
使用 #pragma once 可以让编译器在第一次处理该头文件后，自动忽略后续的包含请求。
例如：#ifndef MYCLASS_H
#define MYCLASS_H
class MyClass {
// ...
};
#endif // MYCLASS_H
这是传统的“头文件守卫”写法，而使用 #pragma once 可以简化为：
立即学习“C++免费学习笔记（深入）”；
#pragma once
class MyClass {
// ...
};
效果相同，但代码更简洁，不易出错。
与传统宏守卫的对比
#pragma once 和传统的 #ifndef / #define / #endif 守卫都能实现防重包含，但各有特点：
- #pragma once 由编译器保证唯一性，基于文件路径判断，写法简单，减少人为命名错误。
- 宏守卫依赖手动定义唯一的宏名，若命名冲突或遗漏，会导致问题；但兼容性更好，适用于所有标准C++编译器。
- 某些特殊情况下（如同一文件有多个路径访问），#pragma once 可能失效，而宏守卫更可控。
使用建议
现代主流编译器（如 MSVC、GCC、Clang）都支持 #pragma once，因此在新项目中推荐使用它来提高代码可读性和编写效率。
- 放在头文件的第一行有效代码处。
- 不需要考虑宏命名规则，避免命名污染。
- 仍需注意文件路径唯一性，避免符号链接或多重路径引发异常。
基本上就这些。#pragma once 不复杂但容易忽略细节，合理使用能让头文件管理更轻松。
