文章同步於blog

前言

終於到最後一個Clean Code的文章....大概吧
只能說這本書真的太多
完全沒辦法幾天之內介紹完
真的介紹完我也要壓縮一大堆
所以就直接帶到最後我預定介紹的主題 - 程式碼的氣味與啟發

註解(Comments)

對我們又要來講註解了，對於Clean Code來說，程式碼就是最好的註解
所以他才會提到那麼多次

我們講個我們之前沒說過的 - 被註解掉的程式碼

現代有非常多工具可以儲存我們的程式碼的歷史紀錄，一定都有用過的就是Git
當上面有過多的被註解掉的程式碼，到最後就不太會有人知道這些事幹嘛的
你說寫註解說這是幹嘛的，不就好了
但，不是每個人的開發習慣都一樣，有些變數或函式是會依賴其他部分的，而且更不用說可能還呼叫到已經被刪除掉的部分。

所以，當你想要把程式碼註解掉的時候，請記得，你還有Git

開發環境(Environment)

相信一定很多人有遇過那種，要一大堆步驟才可以建立整個專案的狀況
這其實完全不應該發生
最好的狀況就是，只用一個指令就可以取出整個程式系統，再用一個指令就能建立好專案

這個容我分享一個鬼故事
曾經我遇過某位仁兄
他老兄給我把PHP檔案的開頭用簡寫，讓我們找了兩天才發現這件事
他才說要把php的設定改成可以用short_tag

拜託各位不要當這種人...

扯遠了

現在我們有Docker可以Run起整個專案，簡單的一個docker-compose up即可架起整個專案

同分原始檔存在多種語言

現在軟體開發是很有機會做到這件事的，像是php、html等等
不過這種做法只會讓人覺得困惑
對於日後接手這個專案的人來說，他根本不懂這些邏輯

所以最理想的狀態就是指使用一種語言，如果真的要使用別種語言，請將其他種語言的範圍降至最低。

結語

Clean Code終於介紹告一個段落
緊接著要講SLOID原則

我們明天見吧

參考資料

Clean Code(程式碼的氣味與啟發)