C# 命名慣例與編碼規範完整指南：帕斯卡、駝峰、匈牙利命名法詳解

良好的命名慣例是程式碼可讀性、可維護性的基石。C# 社群有明確、廣泛遵循的命名標準（Microsoft 官方指南、Framework Design Guidelines）。本文系統整理**帕斯卡命名法**、**駝峰命名法**、**匈牙利命名法**在 C# 中的定義、適用範圍、對照表與實務範例，助你寫出專業級程式碼。

三大命名法快速對照

C# 官方命名規範詳細規則

1. 大寫規則

• 單字： 全大寫 (如 IO, XML, HTML) → XmlDocument, HtmlEncoder (Framework 指南建議**僅首字母大寫**，但兩字母縮寫慣用全大寫)。
• 兩字母縮寫： 全大寫 (如 ID, OK) → UserId (帕斯卡) / userId (駝峰)。
• 三字母以上： 帕斯卡式 (如 Json, Sql, Html)。

2. 各程式元素命名標準

3. 特殊情境

• 非同步方法： 後綴 Async → GetDataAsync()。
• 布林屬性/方法： 加 Is, Can, Has, Should → IsValid, CanExecute。
• 集合屬性： 複數名詞 → Orders, Items (而非 OrderList)。
• 介面實作類別： 同名去 I → IUserService → UserService。

為何 C# 棄用匈牙利命名法？

1. 型別資訊已在 IDE 顯示：滑鼠懸停即知型別，前綴冗餘。
2. 重構時維護成本高：改型別須改名稱，易遺漏。
3. 可讀性降低：strUserName 不如 userName 自然。
4. 泛型/匿名型別下失效：var items = new List<string>(); 前綴何用？

唯一例外：WinForms/WPF 控制項欄位命名慣例 (txtName, btnSave, dgvUsers) 仍廣泛使用，因設計器產生代碼、事件綁定慣例所致。新專案建議改用純語意命名 (nameTextBox, saveButton)。

.editorconfig 強制團隊風格

在專案根目錄加入 .editorconfig，IDE 即可即時提示/自動修正：

root = true

[*.cs]
# 命名風格
dotnet_naming_style.pascal_case.capitalization = pascal_case
dotnet_naming_style.camel_case.capitalization = camel_case

# 公用成員必須帕斯卡
dotnet_naming_rule.public_members_must_be_pascal.symbols = public_members
dotnet_naming_rule.public_members_must_be_pascal.style = pascal_case
dotnet_naming_rule.public_members_must_be_pascal.severity = warning

# 參數/區域變數必須駝峰
dotnet_naming_rule.locals_parameters_camel.symbols = locals_parameters
dotnet_naming_rule.locals_parameters_camel.style = camel_case
dotnet_naming_rule.locals_parameters_camel.severity = warning

# 符號定義
dotnet_naming_symbols.public_members.applicable_kinds = property,method,field,event,delegate
dotnet_naming_symbols.public_members.applicable_accessibilities = public,internal,protected,protected_internal
dotnet_naming_symbols.public_members.required_modifiers = readonly

dotnet_naming_symbols.locals_parameters.applicable_kinds = local,parameter

結語

**命名是給人看的，順便給編譯器過目。** 遵循 C# 慣例：

• **公用介面用帕斯卡** → 清楚表達契約。
• **內部實作用駝峰** → 輕快自然。
• **拒絕匈牙利** → 讓型別系統做它的事。
• **善用 .editorconfig** → 團隊零爭辯，專注業務邏輯。

統一命名風格，是專業團隊最低成本、最高回報的品質投資。