C# 變數命名規則與最佳實務：從語法限制到可讀性原則

變數名稱是程式碼可讀性的第一道防線。C# 對識別碼有嚴格的語法規範，同時社群也沉澱出一套約定俗成的命名慣例。本文同時涵蓋「編譯器強制規則」與「工程實務建議」。

編譯器強制規則（違反即報錯）

• 首字元限制：必須為字母或底線（_），不可為數字。
• 字元集合：僅允許字母、數字、底線；不得包含空格、標點、運算子等特殊符號。
• 關鍵字保留：不可與 C# 關鍵字（如 class、int、foreach）同名。完整清單見附錄 A。
• 庫函數衝突：避免與 BCL 常用型別/成員同名（如 Console、WriteLine），雖非語法錯誤但極易造成混淆。

特例：@ 前綴逃逸機制

若確需使用關鍵字作為識別碼（如與其他語言互通時），可加 @ 前綴：

int @class = 1; // 合法，@ 不屬於名稱一部分
string @foreach = "test";

注意：@ 僅供編譯器辨識，IL 中不存在。除互通場景外，不建議常態使用。

合法與非法範例對照

工程實務：描述性命名原則

• 語意清晰：messageText 優於 s1；userCount 優於 cnt。
• 慣例前綴：私有欄位 _camelCase、常數 PascalCase、介面 I 開頭等。
• 避免縮寫：除領域通用術語（如 Id、Url），盡量拼寫完整單字。

單行宣告多變數

int a, b, c = 50, d; // 僅 c 被初始化

建議：為提升可讀性與除錯便利性，傾向每行一個變數宣告，並就地初始化。