头文件 自包含 举例_深度理解：#pragma once防止文件重复包含

今天的主题，做C++的朋友可能都不会太陌生。此文的目的，主要是深挖一下这个#pragma once。

示例代码

在以上代码中，我们定义了两个类，CMyBase和CMyDerived，其中CMyDerived继承自CMyBase，所以，这里的CMyDerived需要在其头文件中包含MyBase.h。在我们的客户程序Main.cpp中，我们使用到了CMyBase类和CMyDerived类，所以需要包含着两个类的头文件。

为了探究#pragma once的作用，我在基类CMyBase的头文件的第一行，添加了如下代码：

#pragma message(“Including MyBase.h”)

这句代码的意思是：每当编译器包含CMyBase的头文件时，都输出一行”Including MyBase.h”的日志。

现在，我们来编译Main.cpp，观察编译输出：

可以看到，虽然Main.cpp包含了两次MyBase.h，一次是在Main.cpp中直接包含，一次是通过MyDerived.h间接包含。实际编译时，MyBase.h头文件也只会被包含一次。因为我们的日志输出放在了MyBase.h头文件中的第一行，所以，编译器在编译的时候，也只会打开MyBase.h这个头文件一次，也即文件的IO操作，只有一次。

以上，我们验证了#pragma once的实际效果。

冗余包含哨卫

在<>一书中，作者推荐使用如下的冗余包含哨卫来实现同样的效果。

在以上代码中，通过双重#ifndef语句，也实现了只包含一次头文件且只进行一次文件IO操作的效果。但是从代码结构上来看，需要为每一个头文件都编制#ifndef，需要保证符号的唯一性，而#pragma once则没有这样的顾虑，编译器内部已经确保了符号的唯一性。

结论

1) <>一书中的冗余包含哨卫可以解决头文件重复包含的问题，也实现了作者所说的仅扫描一次(文件IO操作)的优化措施。

2) #pragma once可以达到同样的效果，且无需关心符号的唯一性的问题，而冗余包含哨卫需要程序员实现符号唯一性。

3) 相对于#ifndef，#pragma once可能跨编译器兼容性稍稍差一点。

4) 如编译平台固定，推荐使用#pragma once。