作者Ghamu (貓丸)
看板Soft_Job
標題Re: [請益] 寫註解到底是不是好習慣
時間Sat Dec 29 04:36:59 2018
個人淺見
註解是可恥的
代表你程式不夠乾淨
變數 函式名稱詞不達意 只能靠註解補完
最近手上接到外包的程式碼
有一個核心處理封包差不多200行程式碼
裡面做什麼呢？
他有好心寫上註解
//處理messages類型 A
.
.
.
//處理類型B
.
.
.
//..............C
欸.....
那實際上不就該是
處理類型A();
處理類型B();
處理類型C();
嗎？？？
當註解變多時 或開始寫註解時
就是一個該refactoring的信號了
當然說可恥是有點偏激
主重點在於說應該盡力窮盡所能
讓程式碼即註解
而不是去依賴註解
註解雖然可恥 但是有用
在以下情形我還是會註解
1.英文不夠好
有時候想不到該怎麼描述才清楚
畢竟不是英文母語
只好寫上註解 等未來有緣人幫忙修改
2.變數名稱 函式因為單字太長
冷僻縮寫 我會加上註解 別讓下一個人猜
3. 非正規解法 詭異做法時
最近剛好遇到Java rename 會失敗的問題
一位資深的前輩說是因為裡面一連串動作
有一個錯他就整個錯
建議把他拆開來做 先複製 改名 move 等等
如果自己寫一個rename ()
把這些步驟放進去
下一個人看到
一定會疑惑為什麼要自己重寫吧？
這時候就要加上註解描述是因為有那個風險
才做此改變
簡單的說
程式碼就是註解
註解不要重複描述程式碼
註解要能提供程式碼以外 你的設計意圖
-----
Sent from JPTT on my Sony F5321.
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 114.25.229.193
※ 文章網址: https://webptt.com/m.aspx?n=bbs/Soft_Job/M.1546029421.A.35E.html
1F：推 orange0319: 認同 12/29 09:09
2F：推 Ryuusei: 推一個，我也是只有在程式碼本身不足以表達全部資訊的時 12/29 09:18
3F：→ Ryuusei: 候才寫註解 12/29 09:18
4F：推 Angesi: 等你要離職時 你會後悔寫了註解... 12/29 10:09
5F：推 cookie1115: 推 12/29 13:01
6F：噓 darkMood: 笑死，你到底知不知道什麼時候該寫註解? 12/29 21:50
7F：→ darkMood: 註解的價值和你的廢文無關，不會寫註解不要牽拖註解不好 12/29 21:51
8F：推 bitcch: 3在很多lib裡面很常見 還有上面在氣什麼 12/30 05:28
9F：→ leolarrel: 大家都在理性討論,darkMood 在悲憤啥?? 12/30 14:02
10F：推 ku72: 推~ 01/05 09:16