程式碼寫一次,讀無數次。投入時間撰寫清晰、可讀的代碼,能在後續維護中成倍節省精力。以下整理 11 項經驗證實用的編程技巧。
單一函數應在一個螢幕內閱讀完畢(建議 5-20 行)。過長函數難以掌握上下文,拆分為具體語意的小函數。
一個變數只服務單一目的。善用 const(PHP 8.1+ readonly)宣告不可變量,編譯器可優化,閱讀者也能一眼識別意圖。
變數/函數名應自描述:numTeamMembers 勝過 n、nsisd。除非領域通用縮寫(src/pos/prev),否則拼寫完整單字。
如同蓋房子工具放手邊,變數宣告應盡貼近首次使用位置,減少滾動尋找的認知負擔。
將常數提煉為具名常數:MAX_INPUT_LENGTH 遠勝 4384,語意清晰且易維護。
學習新語言時,採用該語言的慣用寫法。Ruby 用 5.times { puts 'Hi' } 而非 C 風格 for 迴圈。避免把舊語言習慣硬套到新語言。
如 PSR-12(PHP)、Google Java Style。除非有強烈理由,否則不要違背慣例;團隊內部可自訂,但對外發布請遵循主流標準。
先寫正確、可讀的代碼。有效能問題再用 Profiler 定位熱點優化。盲目優化常導致代碼複雜化且引入 Bug。
先確保測試通過(自動化測試最佳),再重構。重構後跑測試驗證無退化。TDD 循環:紅-綠-重構。
模式是溝通與簡化工具,非炫技手段。80 行腳本不需 10 個類別實現「觀察者模式」。依專案複雜度引入,避免過度設計。
引入新框架/庫時,先在專案外寫小 Demo 驗證核心用法,弄懂再套用至產品代碼,降低風險。
Steve McConnell《Code Complete》(中譯《代碼大全》),將徹底改變你對編程的認知。