c++中的#pragma once和头文件防卫有什么区别_c++中#pragma once与传统头文件防卫的使用方法解析

新闻中心 NEWS CENTER

2025-11-04

浏览次数：次

pragma once和传统头文件防卫均防止重复包含，前者依赖编译器记录文件路径实现更简洁，后者通过宏定义保证可移植性；现代项目常用#pragma once，开源库为兼容性多用宏卫。

#pragma once 和传统的头文件防卫（header guards）都能防止头文件被重复包含，但它们在实现机制、可移植性和使用方式上存在差异。下面从原理、用法和实际建议三个方面进行解析。

传统头文件防卫依赖预处理器宏来控制编译行为：

#ifndef MY_HEADER_H
#define MY_HEADER_H

// 头文件内容

#endif // MY_HEADER_H

当该头文件第一次被包含时，宏 MY_HEADER_H 未定义，因此会定义它并包含内容；后续再包含时，由于宏已定义，预处理器会跳过整个内容。

#pragma once 是编译器指令，告诉编译器只允许该文件被包含一次：

VALL-E

VALL-E是一种用于文本到语音生成 (TTS) 的语言建模方法

134 查看详情

#pragma once

// 头文件内容

编译器在处理文件时会记录其物理路径或 inode（在支持的系统上），确保同一文件不会被多次解析。

#pragma once 更简洁，无需手动命名宏，减少拼写错误风险。
宏命名需唯一，传统防卫若宏名冲突会导致错误或意外屏蔽，而 #pragma once 基于文件路径，避免命名问题。
在符号链接或多路径访问同一文件的场景中，某些旧版编译器可能误判 #pragma once，但现代编译器已基本解决。
传统防卫完全符合 C++ 标准，所有编译器都支持；而 #pragma once 属于非标准扩展，尽管主流编译器（如 MSVC、GCC、Clang）均支持。