C++ #pragma once使用方法详解

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

#pragma once 是 C++ 中用于防止头文件被重复包含的一种预处理指令。它的作用是确保在同一个编译过程中，某个头文件只被编译一次，从而避免因重复定义类、函数、变量等导致的编译错误。

基本用法

#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);

与传统宏守卫的对比

#ifndef MATHUTILS_H
#define MATHUTILS_H

double add(double a, double b);

#endif // MATHUTILS_H

#pragma once

double add(double a, double b);

• 写法简单，不易出错（比如宏名冲突或忘记配对）
• 编译器能更高效地识别并跳过重复包含的文件
• 无需手动命名宏，避免命名冲突

注意事项

• 不是 C++ 标准的一部分，但主流编译器（如 MSVC、GCC、Clang）都支持
• 依赖于文件系统的唯一性判断，若同一文件通过不同路径引用（如符号链接），可能失效
• 在某些特殊构建系统中可能不如宏守卫可靠

建议使用场景

基本上就这些。加一行 #pragma once，省事又安全。