C語言內置宏 __FILE__ __LINE__ 實戰：編譯器錯誤定位與調試信息輸出原理

當編譯器報錯「file.c:42: error: ...」時，它是如何知道文件名與行號的？答案在於 C 標準預定義的內置宏：__FILE__ 與 __LINE__。它們不需定義即可直接使用，編譯器在預處理階段自動展開為當前源文件路徑與行號字面量。本文通過實例演示其用法與實戰價值。

常用內置宏一覽

實戰示例：輸出調試定位信息

#include 

void show() {
    printf("hello\n");
    printf("file:%s line:%d func:%s\n", __FILE__, __LINE__, __func__);
}

int main() {
    printf("file:%s line:%d func:%s\n", __FILE__, __LINE__, __func__);
    show();
    return 0;
}

運行輸出

file:test.c line:13 func:main
hello
file:test.c line:7 func:show

進階應用：構建調試日誌宏

將文件、行號、函數名封裝為統一日誌宏，便於發布版本條件編譯關閉。

#ifdef DEBUG
#define LOG(fmt, ...) \
    printf("[DEBUG][%s:%d %s] " fmt "\n", __FILE__, __LINE__, __func__, ##__VA_ARGS__)
#else
#define LOG(fmt, ...) ((void)0)
#endif

// 使用示例
void process(int id) {
    LOG("開始處理 id=%d", id);
    // ...
    LOG("處理完成");
}

編譯器錯誤報告機制原理

GCC/Clang/MSVC 等編譯器內部同樣利用 __FILE__ / __LINE__ 宏：

1. 詞法/語法分析階段維护當前 Token 的位置信息（文件、行、列）。
2. 遇到錯誤時，調用內部診斷函數，參數包含位置信息。
3. 診斷輸出格式化為 file:line:col: level: message。

這也是為什麼宏展開後的代碼行號可能與原始碼不一致——編譯器報告的是展開後的行號。使用 #line 指令可手動調整行號映射。

GDB 配合驗證函數地址

# 1. 編譯帶調試信息
gcc -g demo.c -o demo

# 2. 進入 GDB
gdb ./demo

# 3. 查看函數地址
(gdb) info address show
Symbol "show" is a function at address 0x401126.
(gdb) info address main
Symbol "main" is a function at address 0x401145.

內置宏是 C 語言「零開銷、編譯期計算、靜態反射」能力的典型體現。善用它們能極大提升調試效率、日誌可追蹤性與代碼可維護性。