文章同步於it邦
前言
終於到最後一個Clean Code的文章….大概吧
只能說這本書真的太多
完全沒辦法幾天之內介紹完
真的介紹完我也要壓縮一大堆
所以就直接帶到最後我預定介紹的主題 - 程式碼的氣味與啟發
註解(Comments)
對我們又要來講註解了,對於Clean Code來說,程式碼就是最好的註解
所以他才會提到那麼多次
我們講個我們之前沒說過的 - 被註解掉的程式碼
現代有非常多工具可以儲存我們的程式碼的歷史紀錄,一定都有用過的就是Git
當上面有過多的被註解掉的程式碼,到最後就不太會有人知道這些事幹嘛的
你說寫註解說這是幹嘛的,不就好了
但,不是每個人的開發習慣都一樣,有些變數或函式是會依賴其他部分的,而且更不用說可能還呼叫到已經被刪除掉的部分。
所以,當你想要把程式碼註解掉的時候,請記得,你還有Git
開發環境(Environment)
相信一定很多人有遇過那種,要一大堆步驟才可以建立整個專案的狀況
這其實完全不應該發生
最好的狀況就是,只用一個指令就可以取出整個程式系統,再用一個指令就能建立好專案
這個容我分享一個鬼故事
曾經我遇過某位仁兄
他老兄給我把PHP檔案的開頭用簡寫,讓我們找了兩天才發現這件事
他才說要把php的設定改成可以用short_tag
拜託各位不要當這種人…
扯遠了
現在我們有Docker可以Run起整個專案,簡單的一個docker-compose up
即可架起整個專案
同分原始檔存在多種語言
現在軟體開發是很有機會做到這件事的,像是php、html等等
不過這種做法只會讓人覺得困惑
對於日後接手這個專案的人來說,他根本不懂這些邏輯
所以最理想的狀態就是指使用一種語言,如果真的要使用別種語言,請將其他種語言的範圍降至最低。
結語
Clean Code終於介紹告一個段落
緊接著要講SOLID原則
我們明天見吧
參考資料
Clean Code(程式碼的氣味與啟發)