[TOC] # 簡介 頭文件包含命令 #include 的效果與直接復制粘貼頭文件內容的效果是一樣的，預處理器實際上也是這樣做的，它會讀取頭文件的內容，然后輸出到 #include 命令所在的位置。 頭文件包含是一個遞歸（循環）的過程，如果被包含的頭文件中還包含了其他的頭文件，預處理器會繼續將它們也包含進來；這個過程會一直持續下去，直到不再包含任何頭文件，這與遞歸的過程頗為相似。 遞歸包含會導致一個問題，就是重復引入同一個源文件. # 頭文件只包含一次 ?`#pragma once`是一個比較常用的C/C++雜注，只要在頭文件的最開始加入這條雜注，就能夠保證頭文件只被編譯一次。 ? ? ? ?`#pragma once`是編譯器相關的，有的編譯器支持，有的編譯器不支持，具體情況請查看編譯器API文檔，不過現在大部分編譯器都有這個雜注了。 ? ? ?? `#ifndef，#define，#endif`是C/C++語言中的宏定義，通過宏定義避免文件多次編譯。所以在所有支持C++語言的編譯器上都是有效的，如果寫的程序要跨平臺，最好使用這種方式。 方式一： ~~~ #ifndef _SOMEFILE_H_ #define _SOMEFILE_H_ .......... // 一些聲明語句 #endif ~~~ 方式二： ~~~ #pragma once ... ... // 一些聲明語句 ~~~ 比較 `#ifndef`的方式依賴于宏名字不能沖突，這不光可以保證同一個文件不會被包含多次，也能保證內容完全相同的兩個文件不會被不小心同時包含。當然，缺點就是如果不同頭文件的宏名不小心“撞車”，可能就會導致頭文件明明存在，編譯器卻硬說找不到聲明的狀況。 `#pragma once`則由編譯器提供保證：同一個文件不會被編譯多次。注意這里所說的“同一個文件”是指物理上的一個文件，而不是指內容相同的兩個文件。帶來的好處是，你不必再費勁想個宏名了，當然也就不會出現宏名碰撞引發的奇怪問題。對應的缺點就是如果某個頭文件有多份拷貝，本方法不能保證他們不被重復包含。當然，相比宏名碰撞引發的“找不到聲明”的問題，重復包含更容易被發現并修正。 方式一由語言支持所以移植性好，方式二 可以避免名字沖突 `#pragma once`方式產生于#ifndef之后，因此很多人可能甚至沒有聽說過。目前看來#ifndef更受到推崇。因為#ifndef受語言天生的支持，不受編譯器的任何限制；而`#pragma once`方式卻不受一些較老版本的編譯器支持，換言之，它的兼容性不夠好。也許，再過幾年等舊的編譯器死絕了，這就不是什么問題了。 我還看到一種用法是把兩者放在一起的： ~~~ #pragma once #ifndef __SOMEFILE_H__ #define __SOMEFILE_H__ ... ... // 一些聲明語句 #endif ~~~ 看起來似乎是想兼有兩者的優點。不過只要使用了#ifndef就會有宏名沖突的危險，所以混用兩種方法似乎不能帶來更多的好處，倒是會讓一些不熟悉的人感到困惑。