C語言編程規範全集：縮排、註釋、結構化、正確性與可重用性工業級標準

良好的編程風格是專業工程師的基本素養。本文匯總源自軟體工程實戰的編程規範，涵蓋基本排版、可讀性、結構化、正確性容錯、可重用性五大維度，共 50+ 條具體規則。

一、基本排版規則（養成肌肉記憶）

1. 一聲明/一語句佔一行。
2. { } 獨佔一行，與所屬結構首字母對齊。
3. 下層級語句縮進 1 Tab (建議 4 空格)，全專案統一。

二、可讀性要求（代碼給人看，順便給機器跑）

三、結構化要求（杜絕義大利麵條）

1. 禁用 goto。
2. 禁用等價雙支路（if(a) ... else ... 兩支路完全對稱）。
3. if 強調二選一，禁 else goto、else return。
4. 多路分支用 switch / case。
5. 迴圈單一入口，盡量單一出口（避免多 break/return）。
6. 函數單一出口（唯一 return），便於清理資源。
7. 禁用條件賦值（a = b ? c : d 複雜時拆開）。
8. 避免不必要分支（if (cond) return true; else return false; → return cond;）。
9. 勿以分支替代邏輯表達式（if (a && b) 優於巢狀 if）。

四、正確性與容錯性（生存法則）

五、可重用性（資產化思維）

1. 重複獨立功能抽象為公共庫/組件/類。
2. 公共組件遵循 OO：高內聚、低耦合、封裝性、介面穩定。
3. 公共組件建立使用模板/範例/文檔。

工程落地清單

• 專案根目錄放 .editorconfig、.clang-format、cpplint.cfg。
• CI 流水線接入 clang-tidy、cppcheck、cpplint 自動掃描。
• Code Review 清單掛掛上述規則，違規必改。
• 新人入職第一周：閱讀規範、配置 IDE、提交首個符合規範的 PR。

總結

規範不是束縛，而是團隊協作的共同語言。從「能跑」到「好維護」、從「我懂」到「新人也能懂」，這 50+ 條規則是踏上專業工程師之路的最小必要集合。