程式碼撰寫規範：條件判斷、迴圈與結構化設計最佳實務

良好的程式碼風格關鍵在於一致性與可讀性。本文整理條件判斷、迴圈控制、變數宣告、方法設計等核心規範，助你撰寫清晰、可維護的程式碼。

If-Then-Else 結構規範

採用統一大括號風格，建議格式：

if (條件1) // 註解 {
} else if (條件2) // 註解 {
} else // 註解 {
}

使用 else if 時，務必保留最終 else 區塊處理未預期情況，並加上記錄註解，即使無實際動作。

條件表達式撰寫習慣

恆量置於比較運算子左側：if (6 == $errorNum)。優點：漏寫等號時編譯器會報錯；數值一眼可見，無需眺望表達式尾端。需短暫適應但極具實用性。

Switch 語句規範

• 允許 case 穿透至下一 case，但必須加註解 // FALL THROUGH。
• 必須包含 default 分支，理論不可達，若執行到即觸發錯誤。
• 若需在 case 中宣告變數，將程式碼置於區塊 { ... } 內。

Continue、Break 與三元運算子使用原則

continue 和 break 屬隱蔽的 goto，具有「魔力」，應節制使用。continue 兩大問題：繞過測試條件、繞過遞增/遞減表達式。混用兩者是災難配方。

三元運算子 ?: 規則：

• 條件用括號隔離：(condition) ? func1() : func2();
• 動作盡量用簡單函數。
• ?、: 及動作分行書寫，除非單行清晰可讀。

變數宣告對齊與初始化

宣告區塊對齊，相似初始化程式碼列表化。Token 緊鄰型別而非變數名：

var $mDate
var& $mrDate
var& $mrName
var $mName
$mDate = 0;
$mrDate = NULL;
$mrName = 0;
$mName = NULL;

其他核心規範

• 每行一語句，除非語句高度相關。
• 短方法：限制在一頁內，每方法代表單一技術目的。
• 記錄空語句：while ($dest++ = $src++) ; // VOID 明確標示刻意留空。
• 避免預設非零測試：用顯式比較 if (FAIL != f()) 替代 if (f())，防止回傳值變更導致邏輯錯誤。
• 布林邏輯：以不等式檢測 FALSE：if (FALSE != func()) 而非 if (TRUE == func())。
• 避免嵌入式賦值：犧牲可維護性換取微小效能增益不划算。
• 重用程式碼：建立共用庫、儲存庫，主動詢問與分享，克服「小庫心態」。
• 註解敘事化：註解描述系統故事，記錄決策過程，供未來維護者理解。