C/C++ 預處理指令詳解：#error、#line、#pragma 實戰指南

核心預處理指令深度解析

預處理器在編譯前階段處理以 # 開頭的指令，掌握這些指令能顯著提升代碼的可維護性與跨平台能力。本文重點講解 #error、#line 及常用 #pragma 指令的實戰應用。

#error：編譯期強制報錯

當預處理器遇到 #error 時會立即終止編譯並輸出自定義錯誤訊息，常用於條件編譯中驗證配置參數合法性。

#define SIZE 3
int main() {
    #if SIZE > 4 && SIZE < 36
    #error "SIZE 值必須在 4 到 36 之間"
    #endif
}

若 SIZE 不符合條件，編譯將失敗並提示錯誤訊息，避免不合法配置進入構建流程。

#line：控制編譯器行號與文件名

#line 指令可重置編譯器報告的當前行號與文件名，對代碼生成工具、混合語言編程極具價值。

#include <stdio.h>
void Test();
#line 10 "Hello.c"
int main(int argc, char* argv[]) {
    #define CONST_NAME1 "CONST_NAME1"
    printf("%s\n", CONST_NAME1);
    #undef CONST_NAME1
    printf("%s\n", CONST_NAME1); // 編譯器將報告 Hello.c 第 15 行錯誤
    // ...
}

錯誤提示將顯示 Hello.c(15) : error C2065，而非實際源文件行號，方便生成代碼的除錯追踪。

#pragma 實戰精選

#pragma once：高效防重複包含

置於頭文件頂部，確保編譯期僅包含一次，速度優於傳統 #ifndef 護衛宏，現代編譯器普遍支援。

// grandfather.h
#pragma once
#ifndef GRANDFATHER_H
#define GRANDFATHER_H
struct foo { int member; };
#endif

#pragma comment(lib, ...) ：鏈接器指令嵌入

將庫鏈接指令直接寫入目標文件，免去專案設置中手動添加庫依賴：

#pragma comment(lib, "user32.lib")
#pragma comment(linker, "/include:_mySymbol") // 強制包含符號

#pragma code_seg：代碼段精確控制

指定函數代碼存放的段，驅動開發、嵌入式系統中常用於控制內存佈局：

void func1() { } // 預設 .text 段
#pragma code_seg(".my_data1")
void func2() { } // 存入 .my_data1 段
#pragma code_seg(push, r1, ".my_data2")
void func3() { } // 存入 .my_data2 段
#pragma code_seg(pop, r1)
void func4() { } // 回歸 .my_data1 段

#pragma hdrstop：預編譯頭截斷點

標識預編譯頭文件結束位置，後續頭文件不納入預編譯，平衡編譯速度與磁碟空間。

#pragma warning：精細警告控制

支援禁用、單次報告、視為錯誤等多種策略，並提供堆疊式狀態保存/恢復機制：

#pragma warning(push)
#pragma warning(disable: 4705 4706 4707)
// 特定代碼區塊抑制警告
#pragma warning(pop) // 自動恢復先前警告狀態

此機制極適合在引入第三方頭文件前後局部調整警告等級，避免汙染全局編譯環境。