C/C++ 头文件 #pragma once vs #ifndef

最新推荐文章于 2025-11-14 19:24:48 发布
原创 最新推荐文章于 2025-11-14 19:24:48 发布 · 1.9k 阅读 · 3 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文探讨了C/C++中防止头文件重复包含的两种方法：#pragma once和#include guards。尽管#pragma once在某些编译器中不被早期版本支持，但因其便利性和降低出错概率而被推荐使用。然而，当面临大型项目时，结合使用两种方法以确保双重保险是更好的选择。

C/C++ 头文件防止被重复包含有2种常用的做法，一种是传统的ifndef：

#ifndef HEADER_H
#define HEADER_H

...

#endif // HEADER_H

另一种是稍微新一些的pragma once:

#pragma once
...

远古gcc版本不支持pragma once–gcc 3.4之前的版本不支持pragma once，也就是2006年前的gcc，现在应该没人用这么古老的编译器吧。

我找到2个问答：
c++ - #pragma once vs include guards? - Stack Overflow
c++ - Is #pragma once a safe include guard? - Stack Overflow

里面的大部分回答都是支持使用pragma once，因为更方便，更不容易出错，也更快。

最低0.47元/天 解锁文章
C/C++ 中的 #pragma once 作用是什么？
编程与实战的博客
02-17 5万+
击上方“C语言与CPP编程”，选择“关注/置顶/星标公众号”干货福利，第一时间送达！1、#pragma once有什么作用？为了避免同一个头文件被包含（include）多次，C/C++中有...
C语言中的 `#pragma once`：头文件防重定义的现代方式
m0_62599305的博客
03-12 1158
在 C 和 C++ 编程中，我们常常会使用头文件（.h文件）来组织代码和声明函数、结构体等。然而，当多个文件包含同一个头文件时，可能会出现重复定义的问题，导致编译错误。为了避免这种问题，传统上我们使用预处理指令#ifndef#define和#endif来防止头文件被多次包含。然而，随着编译器的改进，成为了一个更简洁和现代的解决方案。本文将深入探讨的使用，了解它如何解决头文件多次包含的问题，并与传统的“防重定义”方法进行比较。📚在使用。
#pragma once与#ifndef的区别
许振坪的专栏
10-30 1246
#pragma once与#ifndef的区别       为了避免同一个文件被include多次，有两种方法：1、#ifndef方式2、#pragma once方式    在能够支持这两种方式的编译器上，二者并没有太大的区别，但是两者仍然还是有一些细微的区别。    方式一：     #ifndef __SOMEFILE_H__    #define __SOMEFILE_H__
【树莓派开发】gcc编译器中出现warning: #pragma once in main file
热门推荐
慕雪华年的博客
03-11 1万+
众所周知，#pragma once语句是防止头文件重复包含非常常用的一条语句 VS编译器在创建.h文件的时候会自动帮你在开头添加这个语句 但是在gcc编译器下，这个语句就可能会出现一些问题 所使用编译器： VS2019（windows10） 树莓派（linux-gcc） warning: #pragma once in main file 在我尝试在linux环境下使用#pragma once语句时，遇到了这个报错 解决这个问题的办法很简单，就是不要编译头文件 编译器会自动展开头文件，无需手动编
【#pragma once】
最新发布
优快云_RTKLIB的博客
11-14 618
本文探讨了 C/C++ 中 #pragma once 预处理器指令的用途与优势。
gcc预处理指令之#pragma once
weixin_34315189的博客
08-22 1629
gcc预处理指令之#pragma once 先看一个例子，假设有三个文件：headerA.h、headerB.h、main.cpp，其内容分别如下： // file: headerA.h struct foo { int member; }; // file: headerB.h #include "headerA...
#pragma once和#ifndef的区别
weixin_33904756的博客
01-02 195
转载自“百度百科”#pragma once 和 #ifndef的区别 #pragma once和#ifdef都是可以避免同一个文件被include多次。在能够支持这两种方式的编译器上，二者并没有太大的区别，但是两者仍然还是有一些细微的区别。1. #pragma once方式这个是编译器相关，就是说在这个编译系统上能用，但是在其他编译系统，不一定行，也就...
#pragma once 和 #ifndef 的区别
桑凯旋的博客
11-25 3217
功能：#pragma once 和 #ifdef 都可以避免同一个文件被 include 多次。 1 #pragma once方式 #pragma once 是编译器相关，移植型差，有些编译器支持，有些编译器不支持，比如：gcc，vs 编译器支持，bcc 编译器不支持。由编译器提供保证，同一个文件不会被包含多次。这里所说的“同一个文件”是指物理上的一个文件，而不是指内容相同的两个文件。不用像使用 ...
c++：#pragma once和#ifndef的区别
weiweiqiao的专栏
07-13 107
C++中防止头文件重复包含的两种机制：传统方法#ifndef通过定义唯一宏名实现跨平台兼容，而#pragma once是非标准但广泛支持的简洁方案。前者严格遵循标准但需手动命名，后者编译效率更高但存在边缘情况失效风险。现代项目推荐优先使用#pragma once，重要库可混合两种方式（双重保护）兼顾可靠性。主流编译器均支持#pragma once，仅在极老旧环境需强制使用#ifndef。
C++中的头文件保护方式——#pragma once和#ifndef的比较
HackNebulaZ的博客
08-29 733
综合比较，#pragma once是更为简洁高效的头文件保护方式，但是由于它不是标准的，所以有的编译器可能会不支持，因此在编写需要具有通用性的代码时，建议使用#ifndef来进行头文件保护。在C++编程中，头文件是非常常用的一种文件。在C++中，常用的头文件保护措施有两种：#pragma once和#ifndef。#pragma once是一种非标准的头文件保护方式，它可以确保一个头文件在一个编译单元中只被包含一次。需要注意的是，#pragma once与#ifndef不能同时使用，否则会出现冲突。
C/C++ #pragma once（与#ifndef比较）防止头文件被重复包含
LU_ZHAO的博客
02-08 818
在C和C++编程语言中，#pragma once是一个非标准但是被广泛支持的前置处理符号，会让所在的文件在一个单独的编译中只被包含一次。它会加快编译速度，编译器会自动比对文件名称而不需要在头文件使用#ifndef和#endif。 #pragma once #ifndef __SOMEFILE_H__ #define __SOMEFILE_H__ //...声明语句 #endif #pragma...
#pragma once与#ifndef的区别?
布袋和尚
12-20 481
#prama once和#ifndef的区别
#pragma once 和 #ifndef 的区别
CodingStart
05-18 689
#pragma once 和 #ifndef 的区别
#pragma once与 #ifndef的区别
xyzhangDaniel的专栏
08-17 617
转自：http://baike.baidu.com/view/1276747.html?fromTaglist   #pragma once 　　#pragma once 　　这是一个比较常用的指令,只要在头文件的最开始加入这条指令就能够保证头文件被编译一次
#pragma once和#ifndef有什么区别呢？
weixin_43914789的博客
04-18 268
在c++中，在使用预编译指令#include的时候，为了防止重复引用造成二义性，通常有两种方式： #ifndef指令 #ifndef __SOMEFILE_H__ #define __SOMEFILE_H__ // 声明语句 #endif pragma once指令（建议使用） //写在文件开头 #pragma once 区别： #ifndef方式是由C++语言的标准支持，在过去比较...
#pragma once 与 #ifndef 的区别
wanwancs的专栏
12-09 1571
为了避免同一个文件被include多次<br /><br />1   #ifndef方式<br />2   #pragma once方式<br /><br />在能够支持这两种方式的编译器上，二者并没有太大的区别，但是两者仍然还是有一些细微的区别。<br />    方式一：<br />    #ifndef __SOMEFILE_H__<br />    #define __SOMEFILE_H__<br />    ... ... // 一些声明语句<br />    #endif<br />    方
#pragma once 与 #ifndef的区别
苦逼的程序猿
04-07 348
#pragma once 　　这是一个比较常用的指令,只要在头文件的最开始加入这条指令就能够保证头文件被编译一次。 　　#pragma once用来防止某个头文件被多次include， #ifndef，#define，#endif用来防止某个宏被多次定义。 　　#pragma once是编译相关，就是说这个编译系统上能用，但在其他编译系统不一定可以，也就是说移植性差，不过现...
使用头文件保护宏（#ifndef/#define/#endif）或#pragma once防止头文件被多次包含
08-24
<think>我们正在讨论使用头文件保护宏或#pragma once来防止头文件被多次包含。 首先，这两种方法都是为了防止在同一个翻译单元中多次包含同一个头文件，从而避免重定义错误。 然后，解释两种方法的使用方式，并比较它们的优缺点。 最后，根据要求提出相关问题。 回答结构： 1. 介绍头文件保护的目的。 2. 分别说明两种方法的使用。 3. 比较两种方法的优缺点。 4. 提出3-5个相关问题。 注意：必须使用中文，并在最后以“§§相关问题§§”开头，然后列出问题。</think>在 C/C++ 开发中，使用头文件保护机制是避免重复包含导致重定义错误的关键技术。以下是两种主流方法的详细说明和最佳实践： ### 1. 传统宏保护（`#ifndef/#define/#endif`） ```cpp // 头文件 example.h #ifndef EXAMPLE_H // 唯一标识符（通常用文件名大写+下划线） #define EXAMPLE_H // 定义保护宏 // 头文件内容（声明、类定义等） class MyClass { // ... }; #endif // EXAMPLE_H // 结束保护 ``` **原理**：首次包含时定义宏，后续包含时因宏已定义而跳过内容 **优点**： - 跨平台兼容（所有标准编译器支持） - 精确控制包含范围（可分段保护） ### 2. 编译器指令（`#pragma once`） ```cpp // 头文件 example.h #pragma once // 单行指令（必须放在首行） // 头文件内容 class MyClass { // ... }; ``` **原理**：编译器内部记录文件物理路径，自动跳过重复包含 **优点**： - 编码简洁（无需维护唯一宏名） - 编译速度更快（无需解析宏逻辑） ### 关键对比 | 特性 | 宏保护 | `#pragma once` | |--------------------|----------------------|----------------------| | 标准支持 | C89/C++98 起 | 编译器扩展（非标准） | | 唯一性要求 | 需手动确保宏名唯一 | 自动识别文件路径 | | 符号链接处理 | 安全 | 某些编译器可能出错 | | 跨文件重复包含防护 | 仅防同一文件多次包含 | 可防不同路径同名文件 | ### 最佳实践 1. **新项目优先用 `#pragma once`**（现代编译器如 GCC≥3.4/MSVC/Clang 均支持） 2. **需要严格跨平台时用宏保护**（如嵌入式开发） 3. **避免混合使用**（同一头文件不要同时用两种机制） 4. **文件命名规范**： - 宏保护名：`<PROJECT>_<PATH>_<FILE>_H_`（如 `MYAPP_UTILS_MATH_H_`） - 文件名：全小写+下划线（如 `network_utils.h`） > ⚠️ **注意**：头文件保护仅防止同一翻译单元（.cpp文件）内重复包含，不能解决跨文件的全局变量重定义问题（需配合 `extern` 或 `inline`）
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值