代码整洁之道-08
如何寫好函數?
1.函數要短小。每個函數的命名要清晰,長度要適當,只完成一件事。
2.每個函數一個抽象層級。每個函數后面都跟著位于下一抽象層級的函數,這樣在查看函數列表時,就能循著抽象層向下閱讀了。
3.短小的switch語句。最好將switch語句埋在抽象工廠底,不讓任何人看到。
4.使用描述性的函數名稱。不要害怕名稱長,具有描述性的名稱優于短名稱。
5.函數參數盡可能少。參數不易對付,測試人員應該深有體會。
6.無副作用。只要保證一個函數只做一件事,這種情況就不會存在。
7.一個函數應該只做某件事或回答是什么事,兩者不可兼得。比如一個函數應該修改某對象的狀態或返回該對象的有關信息,兩樣都干會導致混亂。
8.使用異常替代返回錯誤碼。
9.抽離Try/catch代碼塊。它會搞亂代碼結構,把錯誤處理與正常流程分開,另形成函數。
10.錯誤處理函數只做一件事,cache/finally代碼塊后面不該有其他內容。
11.相同功能的函數不要重復出現。
12.每個函數應該只有一個入口,一個出口。
說明:寫代碼和寫文章類似,一開始都冗長而復雜,然后經過多次打磨,分解函數,修改名稱,消除重復,最后重新組裝打磨后的代碼。一開始就按照上面12條規則寫代碼,我想很難有人做到。
《新程序員》:云原生和全面數字化實踐50位技術專家共同創作,文字、視頻、音頻交互閱讀總結
- 上一篇: 什么是schema?
- 下一篇: K8S网络策略总结