pragma once是防止头文件重复包含的预处理指令,确保头文件只被编译一次,避免重复定义错误。它比传统宏守卫更简洁、安全,写法简单且避免命名冲突,主流编译器均支持。但因非C++标准且依赖文件系统唯一性,在跨平台项目中可结合宏守卫使用以提升兼容性。

#pragma once 是 C++ 中用于防止头文件被重复包含的一种预处理指令。它的作用是确保在同一个编译过程中,某个头文件只被编译一次,从而避免因重复定义类、函数、变量等导致的编译错误。
基本用法
只需在头文件的开头位置添加 #pragma once 指令即可:#pragma once
// 你的头文件内容
#ifndef MYCLASS_H
#define MYCLASS_H // 这行不再需要(如果已经用了 #pragma once)
...
#endif
#pragma once
double add(double a, double b);
double multiply(double a, double b);
与传统宏守卫的对比
传统方式使用 include 守护(include guards):#ifndef MATHUTILS_H
#define MATHUTILS_H
double add(double a, double b);
#endif // MATHUTILS_H
#pragma once
double add(double a, double b);
- 写法简单,不易出错(比如宏名冲突或忘记配对)
- 编译器能更高效地识别并跳过重复包含的文件
- 无需手动命名宏,避免命名冲突
注意事项
#pragma once 虽然广泛支持,但也有一些限制:- 不是 C++ 标准的一部分,但主流编译器(如 MSVC、GCC、Clang)都支持
- 依赖于文件系统的唯一性判断,若同一文件通过不同路径引用(如符号链接),可能失效
- 在某些特殊构建系统中可能不如宏守卫可靠
建议使用场景
现代 C++ 项目中,推荐使用 #pragma once,特别是在个人项目或团队协作中提高编码效率。大型跨平台项目可结合规范化的宏守卫以确保最大兼容性。基本上就这些。加一行 #pragma once,省事又安全。











