PTT動漫區 / C_Chat (希洽)

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

看板C_Chat (希洽)作者 (伊恩可可)時間13小時前 (2024/12/25 18:20), 編輯推噓273(276推 3噓 390→)
留言669則, 284人參與, 1小時前最新討論串1/5 (看更多)
餓死抬頭 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, 13小時前 , 1F
不加註解的一定是超級有能的傢伙
12/25 18:21, 1F
→
12/25 18:21, 13小時前 , 2F
這就一樣兩派人士在吵啊
12/25 18:21, 2F
→
12/25 18:21, 13小時前 , 3F
我自己寫的東西不加註解半年後我就不知道它在幹嘛了
12/25 18:21, 3F
推
12/25 18:21, 13小時前 , 4F
超嚴重，因為幾個月後會連寫的人可能都看不懂
12/25 18:21, 4F
推
12/25 18:21, 13小時前 , 5F
前提是code寫的讓人看不懂，還不加註解
12/25 18:21, 5F
→
12/25 18:21, 13小時前 , 6F
接手的很麻煩，要多花時間理解
12/25 18:21, 6F
→
12/25 18:21, 13小時前 , 7F
遇過同事是說你要寫註解才能看懂表示寫得爛的
12/25 18:21, 7F
推
12/25 18:21, 13小時前 , 8F
還有只把註解當分隔線用的XD
12/25 18:21, 8F
推
12/25 18:22, 13小時前 , 9F
大概跟大便不沖水一樣的等級
12/25 18:22, 9F
→
12/25 18:22, 13小時前 , 10F
歷史本文
12/25 18:22, 10F
推
12/25 18:22, 13小時前 , 11F
看複用性
12/25 18:22, 11F
→
12/25 18:22, 13小時前 , 12F
寫的爛又不註解的真的該死
12/25 18:22, 12F
→
12/25 18:22, 13小時前 , 13F
就算是自己寫的也可能幾個月後看不懂
12/25 18:22, 13F
→
12/25 18:22, 13小時前 , 14F
我自己是沒意見 看主管(
12/25 18:22, 14F
推
12/25 18:22, 13小時前 , 15F
不一定 要看是不是寫垃圾
12/25 18:22, 15F
→
12/25 18:22, 13小時前 , 16F
註解就是為了這段以後需要改時要用的
12/25 18:22, 16F
推
12/25 18:22, 13小時前 , 17F
寫得好就不太需要 太多註解反而更難讀
12/25 18:22, 17F
→
12/25 18:22, 13小時前 , 18F
如果你很清楚這東西就是這次用完就丟的 就沒差
12/25 18:22, 18F
推
12/25 18:22, 13小時前 , 19F
比註解寫的像日記隨筆的好一點
12/25 18:22, 19F
→
12/25 18:23, 13小時前 , 20F
更慘的是註解沒有維護的 地獄模式
12/25 18:23, 20F
→
12/25 18:23, 13小時前 , 21F
函式參數名稱取的有其意義也算是種註解
12/25 18:23, 21F
推
12/25 18:23, 13小時前 , 22F
連自己都不一定看的懂了
12/25 18:23, 22F
推
12/25 18:23, 13小時前 , 23F
除非你的變數名稱取得一目了然
12/25 18:23, 23F
→
12/25 18:23, 13小時前 , 24F
我直接給你一個題目 a + b = 5
12/25 18:23, 24F
→
12/25 18:23, 13小時前 , 25F
然後告訴你 a 和b都是一個正整數 而且在設計者心中是一
12/25 18:23, 25F
→
12/25 18:23, 13小時前 , 26F
個唯一解。就這樣
12/25 18:23, 26F
→
12/25 18:23, 13小時前 , 27F
不是，是註解內容與事實不符，成年累月不刪的錯誤訊息誤導
12/25 18:23, 27F
推
12/25 18:23, 13小時前 , 28F
這垃圾是誰寫的，喔 是我==
12/25 18:23, 28F
→
12/25 18:23, 13小時前 , 29F
寫得極好可以不加註解 這是真的
12/25 18:23, 29F
→
12/25 18:23, 13小時前 , 30F
不過你們這些庸才不要隨便就自認為寫得很好嘛
12/25 18:23, 30F
→
12/25 18:23, 13小時前 , 31F
要不然三個月後你會抱怨三個月前的自己
12/25 18:23, 31F
→
12/25 18:23, 13小時前 , 32F
當你分析半天發現註解在搞你，你會更生氣
12/25 18:23, 32F
推
12/25 18:24, 13小時前 , 33F
看可讀性 像變數都命名無意義a,b,c的不加註解就很糟
12/25 18:24, 33F
推
12/25 18:24, 13小時前 , 34F
寫得好其實不需要太多註解
12/25 18:24, 34F
→
12/25 18:24, 13小時前 , 35F
把說明文件寫好還比較重要
12/25 18:24, 35F
→
12/25 18:24, 13小時前 , 36F
好。請問。當你急用。必須知道a b是什麼時。你會不會很
12/25 18:24, 36F
→
12/25 18:24, 13小時前 , 37F
會不寫註解，八成是是能力很強的g8人= =
12/25 18:24, 37F
→
12/25 18:24, 13小時前 , 38F
幹設計者不註解a b是多少？
12/25 18:24, 38F
推
12/25 18:24, 13小時前 , 39F
顧不顧人怨先不論，一個月後你就會恨自己了
12/25 18:24, 39F
還有 590 則推文
推
12/25 22:04, 9小時前 , 630F
笑死這串怨氣是多重
12/25 22:04, 630F
推
12/25 22:12, 9小時前 , 631F
理論上應該是要能不寫註解就看懂得
12/25 22:12, 631F
推
12/25 22:21, 9小時前 , 632F
某些特定操作一定要寫吧
12/25 22:21, 632F
→
12/25 22:21, 9小時前 , 633F
不寫就算自己寫的過一陣子回來看也不知道在幹嘛
12/25 22:21, 633F
推
12/25 22:22, 9小時前 , 634F
revirwer叫你加就加，別人看不懂就是你的問題，除非你下
12/25 22:22, 634F
→
12/25 22:22, 9小時前 , 635F
周閃人
12/25 22:22, 635F
推
12/25 22:28, 9小時前 , 636F
看到大家的回應忽然覺得自己記憶力沒那麼差了
12/25 22:28, 636F
推
12/25 22:32, 9小時前 , 637F
有版控就別屯了
12/25 22:32, 637F
→
12/25 22:33, 9小時前 , 638F
但註解寫錯不會出事，Code寫錯會，註解錯了了不起改一下
12/25 22:33, 638F
→
12/25 22:33, 9小時前 , 639F
，也不用重跑測試
12/25 22:33, 639F
推
12/25 22:37, 9小時前 , 640F
不太確定你想表達的意思。寫錯會出事是很好的特性..或
12/25 22:37, 640F
→
12/25 22:37, 9小時前 , 641F
許不是真的很好，但寫錯不會出事肯定是很爛的特性。
12/25 22:37, 641F
推
12/25 22:47, 8小時前 , 642F
我通常都寫：別動，我也不知道為什麼可以運作
12/25 22:47, 642F
推
12/25 22:59, 8小時前 , 643F
丟給AI
12/25 22:59, 643F
推
12/25 23:08, 8小時前 , 644F
要寫 但必須只有自己能幹 不然老闆隨時辭退你
12/25 23:08, 644F
推
12/25 23:29, 8小時前 , 645F
如果你看到匪夷所思的註解 必須知道這是日常 XD
12/25 23:29, 645F
推
12/25 23:29, 8小時前 , 646F
變數參數不好好命名，命名abc的才是在搞
12/25 23:29, 646F
推
12/25 23:34, 8小時前 , 647F
會，超幹，寫註解反而搞的更難懂就更麻煩了
12/25 23:34, 647F
→
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, 7小時前 , 652F
我大學升書研究所左右看清自己只是凡人後明白一個道理，
12/25 23:45, 652F
→
12/25 23:45, 7小時前 , 653F
就是寫任何報告或程式，一定要遵循「三個月後自己回來看
12/25 23:45, 653F
→
12/25 23:45, 7小時前 , 654F
能看懂」的原則，不然寫出來的東西都是只能用一次的廢物
12/25 23:45, 654F
→
12/25 23:57, 7小時前 , 655F
最好的扣 是不用註解
12/25 23:57, 655F
→
12/25 23:58, 7小時前 , 656F
完美的程式或是小流程，不太維護不太修改的沒註解沒差，常
12/25 23:58, 656F
→
12/25 23:58, 7小時前 , 657F
維護的沒註解最後一人加一段就沒人認得了
12/25 23:58, 657F
推
12/26 00:04, 7小時前 , 658F
1. 好的code本身要能夠自我解釋 2. 註解是用來寫你這段code想
12/26 00:04, 658F
→
12/26 00:04, 7小時前 , 659F
要達成的事情，而不是這段code實現的細節
12/26 00:04, 659F
→
12/26 00:21, 7小時前 , 660F
還好我覺得
12/26 00:21, 660F
推
12/26 00:39, 7小時前 , 661F
註解還能幹譙人 好註解不寫嗎？
12/26 00:39, 661F
推
12/26 00:47, 6小時前 , 662F
做學生倒是懶得加
12/26 00:47, 662F
→
12/26 00:47, 6小時前 , 663F
理由：1. 多寫多錯 2.分數不會比較高 3. 連自己都看不懂
12/26 00:47, 663F
推
12/26 00:49, 6小時前 , 664F
不加我有可能幾個月後就不知道自己在寫三小
12/26 00:49, 664F
推
12/26 01:49, 5小時前 , 665F
屎山代碼愈來愈多的癥結
12/26 01:49, 665F
推
12/26 02:13, 5小時前 , 666F
歷史本文
12/26 02:13, 666F
推
12/26 02:28, 5小時前 , 667F
註解某種意義上比程式本身還重要
12/26 02:28, 667F
推
12/26 05:50, 1小時前 , 668F
最需要註解的是莫名其妙的feature ，這個不寫一定早晚
12/26 05:50, 668F
→
12/26 05:50, 1小時前 , 669F
出事
12/26 05:50, 669F
‣ 更多 ianlin1216 的文章
文章代碼(AID): #1dQznwdu (C_Chat)
討論串 (同標題文章)
以下文章回應了本文 (最舊先)：
完整討論串 (本文為第 1 之 5 篇)：
排序： 最舊先 | 最新先 | 留言數
在新視窗開啟完整討論串 (共5篇)
C_Chat 近期熱門文章
更多 近期熱門文章 >>
PTT動漫區 即時熱門文章
20
34
[資料] 1208
[ YUGIOH ]
youngluke
11小時前, 12/25
更多 即時熱門文章 >>
‣ 更多 ianlin1216 的文章
文章代碼(AID): #1dQznwdu (C_Chat)