GCC編譯器頭文件與庫文件搜尋路徑完整解析

前言

理解 GCC 如何尋找頭文件（編譯期）與庫文件（鏈接期/運行期）是解決「找不到頭文件」「鏈接失敗」「運行時找不到動態庫」的關鍵。本文基於 RedHat/Fedora + GCC 4.5 環境，系統梳理搜尋順序、環境變數、編譯選項與實戰排查技巧。

一、頭文件搜尋路徑（編譯期）

1. `#include "file.h"` —— 引號形式

1. 當前源文件所在目錄
2. `-iquote` 指定的目錄（依序）
3. 後續視同系統頭文件路徑繼續搜尋

範例：gcc -iquote /bar/foo -I/usr/include/sys *.c

2. `#include ` —— 尖括號形式

搜尋順序：

1. `-I dir1` `-I dir2` ...（用戶指定，左至右）
2. `/usr/local/include`
3. `libdir/gcc/target/version/include`（GCC 內建）
4. `/usr/target/include`
5. `/usr/include`（系統預設）

查看實際路徑：gcc -v -E - < /dev/null 2>&1 | grep "include" -A 20

二、庫文件搜尋路徑（鏈接期）

鏈接器（ld）本身無預設路徑，全部由 GCC 透過 `-L`、`-rpath` 等傳遞。

搜尋優先級（由高到低）

1. `-rpath-link` 或 `-rpath` 指定目錄
2. 環境變數 `LD_RUN_PATH`（若無 rpath 選項）
3. `-L dir1` `-L dir2` ...（用戶指定，左至右）
4. `/usr/lib/gcc/target/version/`（GCC 內建）
5. `/usr/lib/`（系統預設）

注意：實測 GCC 會自動加入 `/usr/local/lib/`，但這在運行期可能找不到，導致「鏈接通、運行失敗」。

傳遞 ld 選項

gcc -Wl,-rpath,/usr/local/lib   # 等價於 ld -rpath /usr/local/lib
gcc -Wl,-rpath-link,/opt/lib

三、動態庫搜尋路徑（運行期）

僅動態鏈接程式涉及，由動態鏈接器（`ld.so`/`ld-linux.so`）處理。

搜尋順序

1. 可執行檔內嵌的 `DT_RPATH` / `DT_RUNPATH`（`-rpath` 硬編碼）
2. 環境變數 `LD_LIBRARY_PATH`（不建議全域設定，建議寫在啟動腳本）
3. `/lib`、`/usr/lib`（系統預設）
4. `/etc/ld.so.cache` 快取 → `/etc/ld.so.conf` 指定目錄

實用工具

# 查看可執行檔內嵌 rpath
readelf -d a.out | grep -i rpath

# 查看/更新快取
ldconfig -p          # 列出所有快取庫
ldconfig -v          # 重建快取並顯示過程
sudo ldconfig        # 更新快取（需 root）

四、實戰排查清單

五、參考資源

• `man gcc` / `man ld` / `man ldconfig`
• GCC 官方文檔：Search Path
• rpath 詳細說明