#pragma once与#ifndef的区别?

最新推荐文章于 2020-04-18 00:11:14 发布
原创 最新推荐文章于 2020-04-18 00:11:14 发布 · 474 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#C++

本文介绍了两种常见的头文件保护方式：#pragma once 和 #ifndef...#define...(声明)#endif。这两种方式都能有效地避免头文件被重复包含，但它们的工作原理及跨平台支持情况有所不同。#pragma once 是一种较新的方法，其简洁易用，但在一些旧版编译器中可能不受支持；而 #ifndef...#define...(声明)#endif 方法则更为传统，几乎在所有的编译环境中都能工作。 
/*
2017-12-20 创建人：Ruo_Xiao
*/

一、#pragma once

  1. 作用：只要在头文件的最开始加入这条指令就能够保证头文件被编译一次。
  2. 最先应用与MicroSoftware Visual C++中，后来陆续被其他编译器所支持，所以不支持跨平台。
  3. 只能对此文件有效，若一个文件有多个拷贝，且工程包含了这些拷贝文件，那么这些文件都会加入到工程中。

二、#ifndef … #define … (声明) #endif

  1. 作用：防止该头文件被重复包含。
  2. 受C/C++语言标准支持,所有支持C++的编译器都支持此预编译指令，所以支持跨平台。
  3. 只要文件内容相同就可防止，即使一个文件的拷贝文件亦可避免重复包含，因为这个是通过宏指令进行判断的。
  4. 缺点：如果ifndef使用的宏之前已经存在了，那么这种方法就会失效，会报找不到类型声明的错误。

三、实例代码

#ifndef __ClassName__H__
#define __ClassName__H__
（各种声明）
#endif

----------

#pragma once
（各种声明）
c++：#pragma once和#ifndef的区别
weiweiqiao的专栏
07-13 100
C++中防止头文件重复包含的两种机制：传统方法#ifndef通过定义唯一宏名实现跨平台兼容，而#pragma once是非标准但广泛支持的简洁方案。前者严格遵循标准但需手动命名，后者编译效率更高但存在边缘情况失效风险。现代项目推荐优先使用#pragma once，重要库可混合两种方式（双重保护）兼顾可靠性。主流编译器均支持#pragma once，仅在极老旧环境需强制使用#ifndef。
C语言头文件避免重复包含、#pragma once和#ifndef区别
07-16
一般情况下，我们都是把函数声明、类定义、模板定义等写到一个头文件里，需要时将相应的头文件用#include包含到源文件（*.cpp文件）里来。但头文件中又允许包含其它的头文件，这样就难免发生某个头文件被重复地包含...
#pragma once与#ifndef的区别
许振坪的专栏
10-30 1243
#pragma once与#ifndef的区别       为了避免同一个文件被include多次，有两种方法：1、#ifndef方式2、#pragma once方式    在能够支持这两种方式的编译器上，二者并没有太大的区别，但是两者仍然还是有一些细微的区别。    方式一：     #ifndef __SOMEFILE_H__    #define __SOMEFILE_H__
#pragma once 和 #ifndef 的区别
桑凯旋的博客
11-25 3209
功能：#pragma once 和 #ifdef 都可以避免同一个文件被 include 多次。 1 #pragma once方式 #pragma once 是编译器相关，移植型差，有些编译器支持，有些编译器不支持，比如：gcc，vs 编译器支持，bcc 编译器不支持。由编译器提供保证，同一个文件不会被包含多次。这里所说的“同一个文件”是指物理上的一个文件，而不是指内容相同的两个文件。不用像使用 ...
#pragma once与 #ifndef的区别
xyzhangDaniel的专栏
08-17 614
转自：http://baike.baidu.com/view/1276747.html?fromTaglist   #pragma once 　　#pragma once 　　这是一个比较常用的指令,只要在头文件的最开始加入这条指令就能够保证头文件被编译一次
#pragma once 与 #ifndef 解析
热门推荐
瘦狐狸的实验室
04-16 2万+
    为了避免同一个文件被include多次，C/C++中有两种方式，一种是#ifndef方式，一种是#pragma once方式。在能够支持这两种方式的编译器上，二者并没有太大的区别，但是两者仍然还是有一些细微的区别。    方式一：    #ifndef __SOMEFILE_H__    #define __SOMEFILE_H__    ... ... // 一些声明语句    #end
#pragma once和#ifndef的区别
weixin_33904756的博客
01-02 194
转载自“百度百科”#pragma once 和 #ifndef的区别 #pragma once和#ifdef都是可以避免同一个文件被include多次。在能够支持这两种方式的编译器上，二者并没有太大的区别，但是两者仍然还是有一些细微的区别。1. #pragma once方式这个是编译器相关，就是说在这个编译系统上能用，但是在其他编译系统，不一定行，也就...
全面了解#pragma once与 #ifndef的区别
12-31
2 #pragma once方式 在能够支持这两种方式的编译器上，二者并没有太大的区别，但是两者仍然还是有一些细微的区别。 方式一： #ifndef __SOMEFILE_H__ #define __SOMEFILE_H__ … … // 一些声明语句 #endif 方式二...
C++ 中pragma once 与 #ifndef _XXX_H_ #define _XXX_H_的区别
12-26
C++ 中pragma once 与 #ifndef _XXX_H_ #define _XXX_H_的区别 pragma once 之前一直用的很好，今天和同事的配合中发现自己没有真正理解pragma once。 原因：同事喜欢把公共的头文件通过生成后事件复制到一个公共的...
#pragma once和#ifndef
06-18 437
C语言中的头文件只是简单的复制粘贴。 C语言中变量、函数、结构体的定义和声明两个过程是分离的。声明通常放在头文件中，为了防止重复声明，需要保证头文件中的内容在构建obj文件时只被包含一次。这可以通过#ifndef宏定义和#pragma once两种方式实现。 #ifndef宏定义的方式： #ifndef SOME_UNIQUE_NAME_HERE #define SOME_UNIQUE_...
#pragma once 和 #ifndef 的区别
CodingStart
05-18 688
#pragma once 和 #ifndef 的区别
#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 1568
为了避免同一个文件被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 335
#pragma once 　　这是一个比较常用的指令,只要在头文件的最开始加入这条指令就能够保证头文件被编译一次。 　　#pragma once用来防止某个头文件被多次include， #ifndef，#define，#endif用来防止某个宏被多次定义。 　　#pragma once是编译相关，就是说这个编译系统上能用，但在其他编译系统不一定可以，也就是说移植性差，不过现...
C++中#pragma once 与 #ifndef 的区别解析
hanshihao1336295654的博客
10-23 391
原文地址：http://blog.youkuaiyun.com/hkx1n/article/details/4313303   作用：为了避免同一个文件被include多次，C/C++中有两种方式，一种是#ifndef方式，一种是#pragma once方式。 在能够支持这两种方式的编译器上，二者并没有太大的区别，但是两者仍然还是有一些细微的区别。      方式一：     #ifndef __SO...
#pragma once 与#ifndef的区别
最新发布
07-03
<think>我们正在讨论C++中两种防止头文件重复包含的预处理指令：`#pragma once`和 `#ifndef`（通常与`#define`和`#endif`一起使用）。根据提供的引用，我将整理它们的区别。###1.标准性-**`#ifndef`**：是C/C++标准的预处理指令，被所有符合标准的编译器支持[^2][^3]。 -**`#pragmaonce`**：是非标准指令，依赖于编译器支持。虽然大多数现代编译器（如GCC、Clang、MSVC）都支持，但在一些老旧的编译器上可能不被支持[^2][^3]。 ###2.实现原理-**`#ifndef`**（宏守卫）：```cpp#ifndef HEADER_FILE_H#define HEADER_FILE_H//头文件内容#endif```原理：检查宏`HEADER_FILE_H`是否已定义。若未定义，则定义该宏并包含头文件内容；若已定义，则跳过内容。它依赖于程序员定义的唯一宏名[^1][^2]。- **`#pragma once`**：```cpp#pragmaonce//头文件内容```原理：由编译器保证同一个物理文件（根据文件系统路径唯一标识）不被重复包含[^2][^5]。 ###3.作用范围- **`#ifndef`**：-可防止同一头文件被多次包含。-也可防止内容完全相同的两个不同头文件被同时包含（因为宏名相同会导致跳过）[^2][^4]。 -**`#pragmaonce`**：-仅防止同一个物理文件被多次包含。-无法防止内容相同但路径不同的两个头文件被重复包含（例如，文件拷贝到不同目录）[^2][^5]。###4.优缺点对比|特性| `#ifndef`(宏守卫)| `#pragmaonce`||---------------------|---------------------------------------|----------------------------------------|| **兼容性**| ✅所有C/C++编译器支持|❌部分老旧编译器不支持（如GCC<3.4）[^3]| |**可读性/简洁性**|❌需手动定义唯一宏名，代码较冗长|✅一行指令，简洁直观|| **处理速度**|⚠️每次包含都需检查宏定义（稍慢）|✅编译器直接记录文件路径（更快）[^2]| |**防重复能力**| ✅可防内容相同的不同文件|❌仅防同一物理文件|| **宏名冲突风险**|❌宏名可能冲突（需确保唯一性）| ✅无宏名冲突问题| ###5.实际使用建议1. **兼容性优先**：若需支持老旧编译器（如嵌入式开发），使用`#ifndef`[^3]。 2. **现代项目**：多数现代项目（如Qt、LLVM）已转向`#pragma once`，因其简洁且编译更快[^2]。 3. **混合使用**：不推荐同时使用两者（如`#pragma once`+`#ifndef`），因为：-不能避免宏冲突问题[^4]。-可能增加编译错误风险（如老旧编译器遇到`#pragma once`报错）。###示例对比```cpp//使用 #ifndef#ifndefMY_HEADER_H#defineMY_HEADER_Hstruct Data{int x; };#endif``` ```cpp//使用 #pragma once#pragmaoncestruct Data{ intx;}; ```###总结- **`#ifndef`**：兼容性强，但依赖唯一宏名且速度稍慢。 -**`#pragmaonce`**：简洁高效，但受限于编译器支持和物理文件路径。 随着编译器迭代，`#pragmaonce`已成为主流选择。在C++20模块（Modules）普及后，两者可能逐渐被取代[^2]。 ---§§相关问题§§1.C++20模块（Modules）如何替代传统头文件机制？2.如何为大型C++项目设计避免命名冲突的头文件结构？3.预处理器指令在编译过程中的具体执行顺序是怎样的？4.为什么C++标准委员会未将`#pragmaonce`纳入标准？[^1]:引用[1]：`#ifndef`通过宏定义实现重复包含检查。[^2]:引用[2][5]：`#pragma once`由编译器保证同一物理文件不被重复包含。[^3]:引用[3]：`#ifndef`受语言天生支持，兼容性更好。 [^4]:引用[4]：混合使用两种方法可能带来混淆。[^5]:引用[5]：`#pragma once`避免了宏名冲突问题。</think>### C++ 中 `#pragma once` 与 `#ifndef` 的区别详解 #### 1. **标准性** - **`#ifndef`** 是 C++ 标准支持的预处理指令，所有编译器必须支持[^3][^4]： ```cpp #ifndef HEADER_H #define HEADER_H // 头文件内容 #endif ``` - **`#pragma once`** 非标准指令，依赖编译器实现（GCC/Clang/MSVC 支持，但老旧编译器可能不支持）[^2][^3]： ```cpp #pragma once // 头文件内容 ``` #### 2. **实现原理** | 特性 | `#ifndef` | `#pragma once` | |--------------------|------------------------------------|------------------------------------| | **检查依据** | 宏名称（如 `HEADER_H`） | 文件的物理路径（操作系统级标识） | | **重复包含防护** | 防止相同宏名的文件重复包含 | 仅防止同一物理文件重复包含[^5] | | **内容相同不同文件**| ✅ 能防护（宏名相同时） | ❌ 无法防护[^2][^5] | #### 3. **性能差异** - **编译速度** `#pragma once` 通常更快，因为编译器直接通过文件系统路径缓存包含状态，无需解析宏定义[^2]。 - **宏处理开销** `#ifndef` 需要预处理器处理宏定义和条件判断，在大型项目中可能产生可测量的开销。 #### 4. **使用风险** - **`#ifndef` 的宏冲突** 不同头文件使用相同宏名会导致防护失效： ```cpp // file1.h #ifndef COMMON_H // 与其他文件冲突 #define COMMON_H // ... #endif ``` - **`#pragma once` 的路径陷阱** 符号链接或相同内容的不同路径文件会被视为不同文件： ```bash src/ ├── header.h └── utils/ └── header.h # 符号链接到上级 ``` 此时包含两个路径会重复包含[^5]。 #### 5. **兼容性与实践建议** | 场景 | 推荐方案 | 原因 | |--------------------|------------------------|-----------------------------------| | 跨平台/老旧编译器 | `#ifndef` | 标准支持，100% 兼容[^3][^4] | | 现代项目 | `#pragma once` | 简洁、编译更快[^2] | | 关键库开发 | 二者同时使用 | 双重保险（但可能增加混淆）[^4] | #### 实际代码示例 ```cpp // 推荐现代用法 (GCC/Clang/MSVC) #pragma once #include <vector> // 兼容性用法 (所有编译器) #ifndef LEGACY_HEADER_H #define LEGACY_HEADER_H #include <string> #endif ``` ### 总结对比表 | 特性 | `#ifndef` | `#pragma once` | |--------------|----------------------------|---------------------------| | 标准性 | ✅ C++ 标准 | ❌ 编译器扩展 | | 防护范围 | 逻辑内容（宏名相同文件） | 物理文件（相同路径文件） | | 编译性能 | 较慢 | 较快[^2] | | 宏冲突风险 | 高 | 无 | | 多副本防护 | ✅ | ❌ | | 代码简洁性 | 冗长（需3行） | 简洁（1行） | > **最佳实践**：现代项目优先用 `#pragma once`，需兼容老旧环境时用 `#ifndef`。避免混用二者，除非有特殊兼容需求[^4]。 ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值