Re: [請益] 寫註解到底是不是好習慣

作者: YAYA6655 (YAYA)   2018-12-29 14:20:40
這個問題很廢話也很刻意
說不用寫註解的也很刻意要顯示自己很會寫碼
講句難聽點的,如果程式可以不用註解,那你從小到大念的國語課本最好也都不用
有註解好了,連生字都不用。
一堆人真的是為了顯示自己很行,換了年紀就換了腦袋。
有種不寫註解,那你小孩的國語課本請他們保留本文就好,其餘的都刪掉。
看他會考幾分。
作者: pttworld (批踢踢世界)   2018-12-29 14:57:00
程式語言關鍵字有限,國文課本生字量可以無限
作者: p122607 ((′▽`))   2018-12-29 15:19:00
課本的單字量哪來的無限
作者: errorsyntax (SyntaxError)   2018-12-29 15:28:00
這比喻滿酷的
作者: qpowjohn (pose)   2018-12-29 15:30:00
其實這比喻看起來蠻正確的?註解是放在沒辦法一眼就看懂的地方
作者: itoni (每天都過得很混)   2018-12-29 15:38:00
拿自然語言和程式語言比 不倫不類
作者: yyc1217 (somo)   2018-12-29 16:07:00
然後他們會叫你去看clean code 卻不思考是否適用所有狀況
作者: alihue (wanda wanda)   2018-12-29 16:24:00
那些推崇不用註解的,都是在寫很簡單的東西吧
作者: molopo (mmm)   2018-12-29 17:57:00
神比喻
作者: Ghamu (貓丸)   2018-12-29 18:08:00
clean code沒說不寫註解啊~ 只是不要寫會過時的註解 重複講一樣的事情等等話說你提到有人自以為強不寫註解 實際上是有很多自以為弱的人寫一堆註解 結果不把寫註解的時間拿去重構用好一點的命名結果永遠不會成長 註解寫得再好 都不會提升 但好的命名好的拆分那是跟你一輩子的 也不會因為需求變更還要去另外維護
作者: gino0717 (gino0717)   2018-12-29 18:17:00
我都把變數寫得跟註解一樣長
作者: Ghamu (貓丸)   2018-12-29 18:19:00
哈哈 不過其實這種討論有點張飛打岳飛 大家心裡定義的註解應該都不一樣 但我個人是認為 [消除重複]應該是核心思維 當註解沒辦法提供程式碼本身以外的資訊 意圖 那他就不該作為程式碼本身的副本出現
作者: oneheat (等待)   2018-12-29 18:20:00
這種沒正解的問題永遠都可以吸引一堆人來發表意見 XD
作者: Ghamu (貓丸)   2018-12-29 18:22:00
以前我曾經幹過命名比註解長的蠢事XDD 後來我發現是因為我忽略本來class的資訊 重複提及了 才會越串越長
作者: oneheat (等待)   2018-12-29 18:25:00
G社通常會把註解放在header檔,或者是export的地方
作者: Ghamu (貓丸)   2018-12-29 18:26:00
其實正解早就有了~ 就在書本裡 但是有很多沒看過的資深人士還拿古代人他習慣那一套做事 有點像現在還有人以為SVN Git或者不用版本管控 這三個選項 只是工具不重要 最重要是事情做完一樣科技 理工界 九成新的東西出來 都是因為要改善舊的缺點 當你聽到一個跟以前差很多的事情 先不及著否定 說不定他們才是隊的
作者: oneheat (等待)   2018-12-29 18:30:00
你說的書本也是一種信仰啊,不同人的信仰不一定一樣
作者: Ghamu (貓丸)   2018-12-29 18:41:00
不太同意那是信仰 新的就是比舊的方式優秀 類似Git是要解決SVN不能決定何時solve conflict 提升平行開放效率 少寫註解
作者: quickey (色肥宅)   2018-12-29 20:08:00
不寫註解他多厲害我是都不信啦
作者: shooter555 (shooter)   2018-12-29 20:26:00
蠻貼切的形容
作者: peanut97 (丁丁)   2018-12-29 21:30:00
這個比喻很棒!本質一樣!
作者: abcf (悠哉悠哉的魚)   2018-12-29 21:35:00
不寫註解,還講一堆clean code這種大道理的話,真是太好笑。
作者: t64141 (榕樹)   2018-12-29 21:59:00
clean code的作者沒有完全反對註解,裡面針對好的註解跟不當的註解也分了兩篇來說,且註解是有沒有適當使用,不是要不要使用的問題
作者: flysonics (飛音)   2018-12-29 23:08:00
幾千行code不寫註解 嗯嗯 你會被接你code的人詛咒到死吧
作者: babelism (Bob)   2018-12-29 23:55:00
從我剛出社會一開始接的案子就是萬行起跳,沒註解你試試
作者: sa074463 (壘包)   2018-12-30 00:07:00
這篇比喻得很好阿。從來就不相信程式碼就是註解
作者: clamperni (肥宅牛牛)   2018-12-30 00:27:00
要看註解寫得怎樣吧 整串討論就二分法寫跟不寫
作者: oneheat (等待)   2018-12-30 00:53:00
這種討論就這樣啊,一個不可能0也不可能1的問題被丟出來,就會有一堆0或1的預設立場去抒發自己的意見
作者: steve1012 (steve)   2018-12-30 02:53:00
到底誰說要完全不寫啦
作者: thethirdfoot (第三隻腳)   2018-12-30 16:19:00
適當的註解可以更快進入狀況
作者: twntwn   2018-12-31 14:15:00
自以為弱有什麼問題 謙虛總比自大好
作者: kira1101 (肉包)   2018-12-31 16:08:00
自以為弱的人常寫沒啥用的註解 用註解掩飾自己的爛扣

Links booklink

Contact Us: admin [ a t ] ucptt.com