C編譯錯誤「expected identifier before numeric constant」排查指南

錯誤現象

編譯器報錯：expected identifier before numeric constant，通常出現在枚舉類型定義處。

根本原因

枚舉常量名與宏定義（#define）產生衝突。預處理階段將宏展開，導致枚舉定義變成非法語法。

典型場景

#define STATUS_OK  0

enum Status {
    STATUS_OK,  // 預處理後變成 "0," —— 非法標識符
    STATUS_ERROR
};

解決方案

1. 重命名枚舉常量：加前綴避免衝突，如 ENUM_STATUS_OK。
2. 刪除或重命名衝突的宏：若宏非必要，直接移除；否則改名如 MACRO_STATUS_OK。
3. 使用 #undef 取消宏：在枚舉定義前加 #undef STATUS_OK。

排查步驟

1. 在項目中全局搜索報錯的枚舉常量名。
2. 檢查是否被 #define 定義過。
3. 應用上述方案修正後重新編譯。

舉一反三

同理，const 變量、普通變量、函數名若與宏名衝突也會引發類似詭異錯誤。良好的命名規範（宏全大寫、枚舉/變量駝峰或下劃線）能有效預防此類問題。