寫出好維護的程式碼 (下) — 日常開發中的實用方法

AI 代理能在很短的時間完成實作，開發速度比過去快上許多。不過，程式碼產出得越快，團隊需要閱讀、審查與維護的程式碼也越多。功能可以動，不代表程式碼容易理解與修改。如果產出的程式碼不好維護，省下的時間最後還是會花在除錯、修改與重構上。也因為如此，工程師需要的不只是把功能寫出來，還要能判斷這段程式碼之後是否容易理解與修改。上一門《寫出好維護的程式碼 (上)》談的是，判斷一段程式碼好不好維護時，可以從哪些角度思考，以及採用不同做法時要注意哪些取捨。有了這些判斷基礎，這一門課會接著談實際寫程式時可以怎麼做。實務上，控制流越寫越深時該怎麼整理？變數與布林值要怎麼命名，才能讓人更快讀懂？什麼情況該寫註解？錯誤發生時該重試、提早回報，還是調整介面，讓例外根本不必出現？這些問題不一定需要改動整體架構，卻會直接影響程式碼好不好讀、好不好改。課程不只會示範程式碼可以怎麼改，也會說明為什麼這樣改，以及哪些情況不一定適用。AI 可以很快把程式碼寫出來，但這段程式碼是否合理、之後是否容易修改，還是需要工程師判斷。不論是自己寫、幫同事做 Code Review，還是檢查 AI 產出的程式碼，這門課都希望讓大家更快看出問題，避免為了追求開發速度，留下更多難以維護的程式碼。