C# 編碼標準：程式設計習慣與最佳實務 66 條完整指南

檔案與類別組織

1. 單一檔案單一類別
2. 單一檔案單一命名空間
3. 檔案行數 ≤ 500 (不含設計器代碼)
4. 方法行數 ≤ 25
5. 方法參數 ≤ 5，超過請用結構/類別封裝
6. 行寬 ≤ 80~120 字元
7. 不手動修改設計器代碼，善用 partial 分離

註解與文件

8. 避免解釋顯而易見的代碼，程式碼應自述性
9. 僅記錄操作假設、演算法洞見、副作用
10. 避免方法級文件，改用 XML 註解 (///) 供 IntelliSense
11. 公開 API 必須有 XML 註解

常數與魔術數字

11. 消除魔術數字，改用 const/readonly/建構子注入
12. const 僅用於真正不變的自然常數 (如 DaysInWeek = 7)
13. 執行期才定值的「常數」用 readonly

斷言與測試

14. 平均每 15 行一個 Debug.Assert 驗證前置/後置條件
15. 每行代碼需經白箱測試覆蓋

例外處理

16. 僅拋出已處理的例外，避免 throw new Exception()
17. catch 區塊重拋時用 throw; 保留堆疊 (非 throw ex;)
18. 避免用回傳碼表示錯誤，改用例外
19. 極少自訂例外；若必要，繼承 ApplicationException 並實作序列化

組件設計

21. 單一進入點 (Main)，EXE 極小化，業務邏輯移至類別庫
22. 預設 internal，僅公開必要 API
23. 避免 InternalsVisibleTo (增加組件耦合)
24. 避免依賴組件載入路徑

列舉設計

26. 不指定明確值，由編譯器自動遞增
27. 不指定底層型別 (預設 int)

控制流程

28. if 區塊永遠用大括號，即使單行
29. 避免三元運算子 ?: (除非極簡單)
30. 條件判斷先存入布林變數，再判斷變數 (利除錯、可讀性)
31. 陣列永遠 0-based
32. 迴圈中顯式初始化參考型別陣列元素

封裝與繼承

33. 無 public/protected 欄位，改用屬性
34. 覆寫基類成員用 override，非 new
35. 非 sealed 類別的 public/protected 方法標記 virtual

非安全代碼與轉型

36. 除非 Interop，否則禁用 unsafe
37. 優先用 as 搭配 null 檢查，避免直接轉型拋例外

委派與事件

38. 引發事件前複製委派到區域變數，避免競態
39. 引發前檢查 != null (或 ?.Invoke)
40. 事件使用 add/remove 存取器封裝委派欄位
41. 考慮使用 EventHandlerList 管理大量事件

介面設計

41. 優先使用介面定義契約
42. 介面方法/屬性比例 ≥ 2:1
43. 避免單一成員介面
44. 介面成員 3~5 個為宜，上限 20 (實際建議 ≤ 12)
45. 介面不含事件
46. 以介面取代抽象基類
47. 類別繼承鏈中顯式實作介面
48. 防禦性查詢介面：obj as IInterface + null 檢查

字串與資源

51. UI 字串使用資源檔 (.resx)，不硬編碼
52. 連線字串等設定值用設定檔 (appsettings.json/web.config)
53. 大量拼接用 StringBuilder

結構體

54. 避免在結構定義方法，改用建構子/運算子多載

靜態建構子

55. 靜態欄位若有初始化邏輯，提供靜態建構子

繫結與診斷

56. 優先早期繫結 (編譯期型別檢查)
57. 使用 Trace/Debug 記錄診斷資訊

其他

58. goto 僅用於 switch fall-through
59. switch 必須有 default 配合 Debug.Assert(false)
60. this 僅用於建構子鏈結 (: this(...))
61. base 僅用於呼叫基類建構子/覆寫成員
62. 實作 IDisposable 模式 (Dispose/Finalize)
63. 避免 object 裝箱/拆箱，用泛型約束或 as
64. 介面不加型別約束，改用強型別介面繼承 (如 ICustomerList : IList<Customer>)
65. 介面成員不加存取修飾詞 (預設 public)
66. 優先使用 .NET 內建泛型集合 (List<T>, Dictionary<TKey,TValue>)