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

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