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