为什么要避免头文件被多次包含

一个大的工程中，有很多.h和.cpp文件，很容易出现某个.cpp文件include了同一个.h文件多次（可以是间接#include而来的）。在编译代码时，如果头文件被多次包含了，则头文件中的变量就会被重复定义，而编译器不允许变量重复定义，因此直接导致代码编译失败。

如何避免头文件被多次包含

方案1：#ifndef宏

#ifndef _SAMPLE_H_
#define _SAMPLE_H_
...
...
#endif

方案2：#pragma once

#pragma once
...
...

两种方案的联系与区别

（1）#ifndef

#ifndef的方式是C/C++语言特性自身支持的。由于编译器每次都需要打开头文件才能判定是否有重复定义，它不仅可以保证同一个文件不会被包含多次，也能保证内容完全相同的两个文件（或者代码片段）不会被不小心同时包含。但是，打开文件判断比较耗时，所以在编译大型项目时，ifndef会使得编译时间相对较长，

初此之外，如果不同头文件中的宏名不小心“撞车”，可能就会导致你看到头文件明明存在，但编译器却硬说找不到声明的状况——这种情况有时非常让人郁闷。

（2）#pragma once

#pragma once 由编译器提供保证：同一个文件不会被包含多次。注意这里所说的“同一个文件”是指物理上的一个文件，而不是指内容相同的两个文件。你无法对一个头文件中的一段代码作pragma once声明，而只能针对文件。

其好处是，你不必再担心宏名冲突了，当然也就不会出现宏名冲突引发的奇怪问题。大型项目的编译速度也因此提高了一些。

对应的缺点就是如果某个头文件有多份拷贝，本方法不能保证他们不被重复包含。当然，相比宏名冲突引发的“找不到声明”的问题，这种重复包含很容易被发现并修正。

另外，这种方式不一定所有编译器都支持，不支持跨平台！

两种方案如何选择

选择哪种方式，应该在了解这两种方式的情况下，视具体情况而定。只要有一个合理的约定来避开缺点，我认为哪种方式都是可以接受的。而这个已经不是标准或者编译器的责任了，应当由程序员自己或者小范围内的开发规范来决定。特别提一下，如果大型项目的话选择用#pragma once还是能提高编译速度的。