GCC 編譯器命令行參數詳細指南

前言

GCC (GNU Compiler Collection) 是 Linux 下最核心的編譯工具鏈。掌握其常用參數、庫鏈接機制、頭文件搜尋路徑、優化選項與環境變數，能大幅提升 C/C++ 開發效率。本文系統整理 GCC 實戰必知知識點。

一、編譯器前端與基本用法

基本編譯流程

# 單檔編譯執行
gcc test.c -o test          # 指定輸出檔名
./test                      # 執行

# 多檔分步編譯
gcc -c main.c -o main.o     # 編譯為目標檔
gcc -c util.c -o util.o
gcc main.o util.o -o app    # 鏈接生成可執行檔

二、常見鏈接錯誤與庫指定

undefined reference to 'xxx' 原因

此為**鏈接階段**錯誤，非編譯錯誤。表示程式碼語法正確，但找不到函式實現。需顯式指定鏈接庫。

-l 與 -L 參數詳解

# 鏈接數學庫 libm.so
gcc test.c -lm -o test

# 庫命名規則：lib<名稱>.so → -l<名稱>
# 例如 libtest.so → -ltest

# 指定庫搜尋路徑 (非標準路徑 /usr/lib, /usr/local/lib)
gcc test.c -L/aaa/bbb/ccc -ltest -o test

庫檔案鏈接關係

libm.so → libm.so.6 → libm-2.3.2.so
# 缺少 libxxx.so 符號鏈接時需手動建立
ln -s libxxx-1.2.3.so libxxx.so

自動獲取鏈接參數：pkg-config

# 列出支援的套件
pkg-config --list-all

# 獲取 GTK+ 編譯與鏈接參數
gcc gtktest.c `pkg-config gtk+-3.0 --cflags --libs` -o gtktest

# 等價於手動輸入：
# -I/usr/include/gtk-3.0 ... -lgtk-3 -lgdk-3 ...

三、頭文件搜尋路徑 (-I, -include)

# 指定頭文件目錄
gcc -I/myinclude test.c -o test

# 當前目錄
gcc -I. test.c -o test

# 強制包含頭文件 (少用)
gcc -include config.h test.c -o test

標準路徑 /usr/include 無需指定。pkg-config --cflags 可自動輸出 -I 參數。

四、優化與進階選項

五、關鍵環境變數

# pkg-config 搜尋 .pc 檔路徑
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:/opt/qt/lib/pkgconfig

# 庫執行時搜尋路徑 (臨時)
export LD_LIBRARY_PATH=/usr/local/lib:/opt/lib

# 編譯器默認搜尋路徑
export C_INCLUDE_PATH=/usr/local/include
export CPLUS_INCLUDE_PATH=/usr/local/include

# 並行編譯加速
export MAKEFLAGS="-j$(nproc)"

六、實戰範例：完整專案編譯

# CMake 專案建議 (現代標準)
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)

# 手動 Makefile 關鍵變數
CC = gcc
CFLAGS = -O2 -Wall -std=c11 -I./include `pkg-config --cflags libxml-2.0`
LDFLAGS = `pkg-config --libs libxml-2.0` -lm -lpthread
TARGET = myapp
OBJS = main.o parser.o network.o

$(TARGET): $(OBJS)
	$(CC) -o $@ $^ $(LDFLAGS)

%.o: %.c
	$(CC) $(CFLAGS) -c $< -o $@

結語

GCC 參數看似繁多，實則邏輯清晰：**編譯階段管頭文件 (-I)、語言標準 (-std)、警告 (-Wall)；鏈接階段管庫路徑 (-L)、庫名稱 (-l)、執行時路徑 (-Wl,-rpath)**。善用 pkg-config 與 CMake 管理複雜依賴，才是現代 C/C++ 開發的正確姿勢。