GCC 頭文件搜尋路徑、宏定義防重複包含與函式宏偵錯技巧全解析

GCC 頭文件搜尋機制詳解

標準搜尋路徑順序

GCC 依序搜尋以下目錄（#include <...>）：

1. /usr/local/include
2. libdir/gcc/target/version/include
3. /usr/target/include
4. /usr/include

C++ 額外搜尋：libdir/../include/c++/version。
target 為編譯目標三元組（如 x86_64-linux-gnu），version 為 GCC 版本號。

常用編譯選項控制搜尋行為

注意：-nostdinc 不影響 -I dir 指定的目錄。目錄名若為 -，需寫成 -I./- 區分。

防止頭文件重複包含：Wrapper #ifndef 模式

/* File: foo.h */
#ifndef FILE_FOO_SEEN
#define FILE_FOO_SEEN

/* 整個頭文件內容 */

#endif /* !FILE_FOO_SEEN */

• 命名慣例： 系統頭文件用 __FILE_H__（雙底線開頭），使用者頭文件建議用 _FILE_H_（單底線）避免衝突。
• C++ 編譯器優化： 會記住 wrapper 狀態，二次包含直接跳過掃描，外部註解不影響優化。

不推薦的替代方案

• #import：Objective-C 機制，將「只包含一次」責任推給使用者，違反封裝原則。
• #pragma once：非標準，部分預處理器不支援，移植性風險高。

行號追蹤與 #line 宏

預處理器自動插入 #line 指令，讓編譯器錯誤訊息能精確定位到原始檔案行號。

glibc 中的函式宏與偵錯陷阱

glibc 許多函式同時提供宏與真實函式兩種實現（如 abs()）。宏展開產生內聯程式碼，速度快但偵錯時行號指向宏定義處而非呼叫處，極難除錯。

強制使用函式版本的兩種方法

#include <stdlib.h>

abs(i);       // 編譯器自行選擇宏或函式
(abs)(i);     // 加括號阻止宏展開，強制函式呼叫
#undef abs
abs(i);       // 取消宏定義後強制函式呼叫

總結

掌握 GCC 頭文件搜尋規則、正確使用 Wrapper #ifndef、理解函式宏的偵錯限制並會強制使用函式版本，是編寫可移植、可維護、可除錯 C/C++ 程式的核心基本功。