PTT動漫區 / C_Chat (希洽)

[閒聊] 寫code不加註解真的很顧人怨嗎

看板C_Chat (希洽)作者 (伊恩可可)時間8月前 (2024/12/25 18:20), 編輯推噓280(283推 3噓 401→)
留言687則, 292人參與, 8月前最新討論串1/6 (看更多)
餓死抬頭 https://i.imgur.com/3QcIsVN.jpeg
本魯不是資工系的啦 所以不知道寫程式不加註解會有多嚴重 想請問相關從業的鄉民 實務上遇到這種情況真的很賭爛嗎 乾五西恰 -- ※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 220.134.201.122 (臺灣) ※ 文章網址: https://www.ptt.cc/bbs/C_Chat/M.1735122042.A.9F8.html
推
12/25 18:21, 8月前 , 1F
不加註解的一定是超級有能的傢伙
12/25 18:21, 1F
→
12/25 18:21, 8月前 , 2F
這就一樣兩派人士在吵啊
12/25 18:21, 2F
→
12/25 18:21, 8月前 , 3F
我自己寫的東西不加註解半年後我就不知道它在幹嘛了
12/25 18:21, 3F
推
12/25 18:21, 8月前 , 4F
超嚴重，因為幾個月後會連寫的人可能都看不懂
12/25 18:21, 4F
推
12/25 18:21, 8月前 , 5F
前提是code寫的讓人看不懂，還不加註解
12/25 18:21, 5F
→
12/25 18:21, 8月前 , 6F
接手的很麻煩，要多花時間理解
12/25 18:21, 6F
→
12/25 18:21, 8月前 , 7F
遇過同事是說你要寫註解才能看懂表示寫得爛的
12/25 18:21, 7F
推
12/25 18:21, 8月前 , 8F
還有只把註解當分隔線用的XD
12/25 18:21, 8F
推
12/25 18:22, 8月前 , 9F
大概跟大便不沖水一樣的等級
12/25 18:22, 9F
→
12/25 18:22, 8月前 , 10F
歷史本文
12/25 18:22, 10F
推
12/25 18:22, 8月前 , 11F
看複用性
12/25 18:22, 11F
→
12/25 18:22, 8月前 , 12F
寫的爛又不註解的真的該死
12/25 18:22, 12F
→
12/25 18:22, 8月前 , 13F
就算是自己寫的也可能幾個月後看不懂
12/25 18:22, 13F
→
12/25 18:22, 8月前 , 14F
我自己是沒意見 看主管(
12/25 18:22, 14F
推
12/25 18:22, 8月前 , 15F
不一定 要看是不是寫垃圾
12/25 18:22, 15F
→
12/25 18:22, 8月前 , 16F
註解就是為了這段以後需要改時要用的
12/25 18:22, 16F
推
12/25 18:22, 8月前 , 17F
寫得好就不太需要 太多註解反而更難讀
12/25 18:22, 17F
→
12/25 18:22, 8月前 , 18F
如果你很清楚這東西就是這次用完就丟的 就沒差
12/25 18:22, 18F
推
12/25 18:22, 8月前 , 19F
比註解寫的像日記隨筆的好一點
12/25 18:22, 19F
→
12/25 18:23, 8月前 , 20F
更慘的是註解沒有維護的 地獄模式
12/25 18:23, 20F
→
12/25 18:23, 8月前 , 21F
函式參數名稱取的有其意義也算是種註解
12/25 18:23, 21F
推
12/25 18:23, 8月前 , 22F
連自己都不一定看的懂了
12/25 18:23, 22F
推
12/25 18:23, 8月前 , 23F
除非你的變數名稱取得一目了然
12/25 18:23, 23F
→
12/25 18:23, 8月前 , 24F
我直接給你一個題目 a + b = 5
12/25 18:23, 24F
→
12/25 18:23, 8月前 , 25F
然後告訴你 a 和b都是一個正整數 而且在設計者心中是一
12/25 18:23, 25F
→
12/25 18:23, 8月前 , 26F
個唯一解。就這樣
12/25 18:23, 26F
→
12/25 18:23, 8月前 , 27F
不是，是註解內容與事實不符，成年累月不刪的錯誤訊息誤導
12/25 18:23, 27F
推
12/25 18:23, 8月前 , 28F
這垃圾是誰寫的，喔 是我==
12/25 18:23, 28F
→
12/25 18:23, 8月前 , 29F
寫得極好可以不加註解 這是真的
12/25 18:23, 29F
→
12/25 18:23, 8月前 , 30F
不過你們這些庸才不要隨便就自認為寫得很好嘛
12/25 18:23, 30F
→
12/25 18:23, 8月前 , 31F
要不然三個月後你會抱怨三個月前的自己
12/25 18:23, 31F
→
12/25 18:23, 8月前 , 32F
當你分析半天發現註解在搞你，你會更生氣
12/25 18:23, 32F
推
12/25 18:24, 8月前 , 33F
看可讀性 像變數都命名無意義a,b,c的不加註解就很糟
12/25 18:24, 33F
推
12/25 18:24, 8月前 , 34F
寫得好其實不需要太多註解
12/25 18:24, 34F
→
12/25 18:24, 8月前 , 35F
把說明文件寫好還比較重要
12/25 18:24, 35F
→
12/25 18:24, 8月前 , 36F
好。請問。當你急用。必須知道a b是什麼時。你會不會很
12/25 18:24, 36F
→
12/25 18:24, 8月前 , 37F
會不寫註解，八成是是能力很強的g8人= =
12/25 18:24, 37F
→
12/25 18:24, 8月前 , 38F
幹設計者不註解a b是多少？
12/25 18:24, 38F
推
12/25 18:24, 8月前 , 39F
顧不顧人怨先不論，一個月後你就會恨自己了
12/25 18:24, 39F
還有 608 則推文
→
12/25 23:39, 8月前 , 648F
註解對開發沒屁用，是因為開發的人不用維護....做維護
12/25 23:39, 648F
→
12/25 23:39, 8月前 , 649F
的人最煩不寫註解的混蛋
12/25 23:39, 649F
推
12/25 23:42, 8月前 , 650F
不加的就保佑不會雷到自己
12/25 23:42, 650F
→
12/25 23:42, 8月前 , 651F
除非心機很重 注釋寫另一份
12/25 23:42, 651F
推
12/25 23:45, 8月前 , 652F
我大學升書研究所左右看清自己只是凡人後明白一個道理，
12/25 23:45, 652F
→
12/25 23:45, 8月前 , 653F
就是寫任何報告或程式，一定要遵循「三個月後自己回來看
12/25 23:45, 653F
→
12/25 23:45, 8月前 , 654F
能看懂」的原則，不然寫出來的東西都是只能用一次的廢物
12/25 23:45, 654F
→
12/25 23:57, 8月前 , 655F
最好的扣 是不用註解
12/25 23:57, 655F
→
12/25 23:58, 8月前 , 656F
完美的程式或是小流程，不太維護不太修改的沒註解沒差，常
12/25 23:58, 656F
→
12/25 23:58, 8月前 , 657F
維護的沒註解最後一人加一段就沒人認得了
12/25 23:58, 657F
推
12/26 00:04, 8月前 , 658F
1. 好的code本身要能夠自我解釋 2. 註解是用來寫你這段code想
12/26 00:04, 658F
→
12/26 00:04, 8月前 , 659F
要達成的事情，而不是這段code實現的細節
12/26 00:04, 659F
→
12/26 00:21, 8月前 , 660F
還好我覺得
12/26 00:21, 660F
推
12/26 00:39, 8月前 , 661F
註解還能幹譙人 好註解不寫嗎？
12/26 00:39, 661F
推
12/26 00:47, 8月前 , 662F
做學生倒是懶得加
12/26 00:47, 662F
→
12/26 00:47, 8月前 , 663F
理由：1. 多寫多錯 2.分數不會比較高 3. 連自己都看不懂
12/26 00:47, 663F
推
12/26 00:49, 8月前 , 664F
不加我有可能幾個月後就不知道自己在寫三小
12/26 00:49, 664F
推
12/26 01:49, 8月前 , 665F
屎山代碼愈來愈多的癥結
12/26 01:49, 665F
推
12/26 02:13, 8月前 , 666F
歷史本文
12/26 02:13, 666F
推
12/26 02:28, 8月前 , 667F
註解某種意義上比程式本身還重要
12/26 02:28, 667F
推
12/26 05:50, 8月前 , 668F
最需要註解的是莫名其妙的feature ，這個不寫一定早晚
12/26 05:50, 668F
→
12/26 05:50, 8月前 , 669F
出事
12/26 05:50, 669F
推
12/26 06:35, 8月前 , 670F
看過註解寫一段佛經的
12/26 06:35, 670F
推
12/26 06:48, 8月前 , 671F
寫註解改code不更新的比較北爛 誤導
12/26 06:48, 671F
推
12/26 08:01, 8月前 , 672F
40樓那個 不是事先知道那個演算法的人應該都看不懂吧 就
12/26 08:01, 672F
→
12/26 08:01, 8月前 , 673F
算有註解也一樣
12/26 08:01, 673F
→
12/26 08:03, 8月前 , 674F
讓人看懂就好 求學時老師說過程式碼不是寫給電腦 是寫給
12/26 08:03, 674F
→
12/26 08:03, 8月前 , 675F
人看的 這句是真的
12/26 08:03, 675F
推
12/26 08:43, 8月前 , 676F
丟chatGPT上註解就好了啊
12/26 08:43, 676F
推
12/26 08:49, 8月前 , 677F
命名弄好可以省一些 不過同事看不懂英文是另一回事了
12/26 08:49, 677F
推
12/26 10:52, 8月前 , 678F
註解重要 但命名更重要 甚至可以犧牲一定效能來遷就可讀性
12/26 10:52, 678F
→
12/26 10:54, 8月前 , 679F
不然debug時候你會痛恨一星期前的自己
12/26 10:54, 679F
→
12/27 14:22, 8月前 , 680F
程式碼的function要從巨觀到微觀，舉例來說你程式做
12/27 14:22, 680F
→
12/27 14:22, 8月前 , 681F
四件事，你main底下最好就只call四個function這樣讀
12/27 14:22, 681F
→
12/27 14:22, 8月前 , 682F
起來就很清楚，然後變數跟function命名很重要
12/27 14:22, 682F
→
12/27 14:24, 8月前 , 683F
註解的問題在於它不改也不會死，所以有時候底下code
12/27 14:24, 683F
→
12/27 14:24, 8月前 , 684F
都改了n次了註解還是最舊版
12/27 14:24, 684F
推
12/27 19:58, 8月前 , 685F
我只有在看不懂自己寫什麼後來又看懂之後才會考慮...
12/27 19:58, 685F
→
12/27 19:59, 8月前 , 686F
可是會優先考慮重構讓程式本身能被看懂...
12/27 19:59, 686F
→
12/27 20:00, 8月前 , 687F
無法重構時才加註解...
12/27 20:00, 687F
‣ 更多 ianlin1216 的文章
文章代碼(AID): #1dQznwdu (C_Chat)
討論串 (同標題文章)
以下文章回應了本文 (最舊先)：
完整討論串 (本文為第 1 之 6 篇)：
排序： 最新先 | 最舊先 | 留言數
在新視窗開啟完整討論串 (共6篇)
C_Chat 近期熱門文章
更多 近期熱門文章 >>
PTT動漫區 即時熱門文章
更多 即時熱門文章 >>
‣ 更多 ianlin1216 的文章
文章代碼(AID): #1dQznwdu (C_Chat)