1. 標頭檔(Header Files) — Google 開源專案風格指南 | 合法醫療器材資訊網

例如函式庫開發者放寬了某個參數類型、替樣板增加預設參數或更改命名空間等等。前置宣告來自std::命名空間的symbols會導致餵定義行為(undefinedbehavior)​。

通常每一個 .cc 文件都有一個對應的 .h 文件。也有一些常見例外, 如單元測試程式碼和只引入 main() 函式的 .cc 文件。

正確使用標頭檔可令程式碼在可讀性、文件大小和編譯性能上大為改觀。

下面的規則將引導你規避使用標頭檔時的各種陷阱。

Tip

標頭檔應該能夠自給自足（self-contained），以 .h 結尾。至於用來插入其他檔案的文件，說到底它們並不是標頭檔，所以應以 .inc 結尾。但請不要以 -inl.h 的方式來撰寫標頭檔。

所有標頭檔要能夠自給自足。換言之，使用者和重構工具不需要為了使用一個標頭檔而引入額外更多的標頭檔。特別是，一個標頭檔應該要有 1.2. #define 保護 (#define Guard)[1]、引入所有它所需要的其它標頭檔，並且不需要任何特別的 symbols 在 include 它前需要被定義。

只有少數的例外，一個標頭檔不是自我滿足的而是用來安插到程式碼某處裡。例如某些文件會被重複的 include 或是文件內容實際上是特定平台（platform-specific）擴展部分。這些文件就要用 .inc 文件擴展名。

如果 .h 文件宣告了一個樣板或內聯 (inline) 函式，同時也在該文件加以定義。凡是有用到這些的 .cc 文件，就得統統引入該標頭檔，否則程式可能會在構建中連結失敗。現在不要把這些定義放到分離的 -inl.h 文件裡了（譯者註：過去該規範曾提倡把定義放到 -inl.h 裡過）。

有個例外：如果某函式樣...