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

[SkankHunt42 (凱子爸)]

※ 引述《ianlin1216 (伊恩可可)》之銘言：
: 餓死抬頭
: https://i.imgur.com/3QcIsVN.jpeg
: 本魯不是資工系的啦
: 所以不知道寫程式不加註解會有多嚴重
: 想請問相關從業的鄉民
: 實務上遇到這種情況真的很賭爛嗎
: 乾五西恰

大家好 我月薪28k軟體工程師啦

我的觀察齁 程式設計師有好幾種類型


1. 無口型

做了很奇怪的事也不註解，commit也找不到原因

等到哪個有重構強迫症的改壞程式以後才發現原來看似很奇

怪很醜的寫法才是最佳解 但因為沒註解所以大家還是繞了一圈

無口型有高手也有智障

2. 廢話型

if(IsMatched()) {
  // IsMatched 回傳true時會進來
  doSomething();
}

典型的話癆，可能以為自己在寫教科書

3. 宅宅型

if(!Initialized()) {
  assert(false && "you shall not pass!!!!!");
}

喜歡在註解裡面埋梗，不懂梗的同事會很痛苦

4. 版本控制是什麼型

// 2024/12/25 by SkankHunt42

不知道版本控制為何物，在註解特地註明自己改了這段程式碼

5. 上班不知道在想什麼型

// ( )( )

可能在想LISP

6. 連環形

// 把這則comment複製到另外3個檔案，7天後之後，你就會升職加薪。
// 如果不複製，績效就會被打C

7. 影片說明型

// The video in this link explains this piece of code.
// https://www.youtube.com/watch?v=dQw4w9WgXcQ


--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 89.187.161.5 (日本)
※ 文章網址: https://www.ptt.cc/bbs/C_Chat/M.1735126937.A.DCA.html
推 lucky0417: 還沒遇過加薪型
推 moe584586: 還好我對這代碼有印象= =
推 shadow0326: 我沒點 那是瑞克搖嗎
推 lslayer: 6是什麼 幸運/不幸的程式碼喔
推 ilohoo: 看到yt代碼就知道影片內容了
推 HJC6666: 亂放奇怪連結不會被幹嗎= =?
推 usoko: 抱歉我是7 我塞了蠻多rickroll在mock data裡.....
→ p3398530: 有遇過1那種的 真的是浪費別人時間
→ ilohoo: 那個代碼在github出現了九萬多次
推 steven3QXD: 宅宅型是我..
→ usoko: 1那種的code review理論上就不可能會過了
推 negisan39: 28k太低了吧塊逃
推 kingo2327: 超好笑你們寫程式的宅宅都這麼幽默嗎= =
推 devilkool: 我喜歡在單元測試裡放宅宅梗
推 deflife: 好希望可以遇到加薪型的
→ devilkool: 理論上code review不會過，前提是要有review
推 kaj1983: 因為寫註解就是想讓別人看到啊
→ kaj1983: 愛怎麼寫就怎麼寫
推 usoko: push權限隨便開那當然是後果自負了 沒有PR誰知道你塞了什麼
→ usoko: 垃圾到repo裡....
推 shadow0326: 所以其他6種code review會過嗎
→ kaj1983: 反正以後有人看到覺得不適合也會刪掉
→ harryron9: 第四個還好吧 嗚嗚嗚
→ usoko: 4根本連git都不會用所以不會出現 其他的會被刪光
推 YellowTiger: 6是三小啦 笑死
推 coronach: 全世界的測試程式不知道有多少You shall not pass…總
→ coronach: 覺得看過很多次
推 miyazakisun2: 4 依公司規定更改的地方起頭跟結束的要寫改版日期
推 storym94374: 哪家公司這樣規定 笑死
推 lanstype: 如果真的是28k也太慘
→ xga00mex: 我廢話型 多寫總比沒寫好 但還是有人能在我寫了的情況
→ xga00mex: 還犯我寫的禁止事項
推 rizman28: Rickroll 笑死
推 Beltran: 應該是28k鎂對吧
推 FCPo011674: 有時候反而變寫太多，結果後續改的人懶的看就是了
推 Curapikt: 超過直男型：錯誤訊息:，"主管說這種情況不會發生"。
→ Curapikt: 結果真的發生了，第一次看到我真的快笑死www
推 gamixxxx: 完了，宅宅型搓到我的笑點
推 smallreader: 還沒點就知道是瑞克搖XD
推 richardz: 我基本不太寫，除非太複雜
推 boooooood: 28k是顧問吧   坐等領錢的
推 tsubasawolfy: AI型呢
推 Jameshunter: 現在看到廢話型的十個有九個是ChatGPT寫的
→ Jameshunter: 有些註解還會上下各空一行
推 jeremy7986: 我看到YT網址就知道是什麼了
推 XFarter: 第四種還好吧 許多函數在重構或搬移的時候有可能會丟失最
→ XFarter: 後的更改時間 這時候 git blame 可看不出來具體的修改時
→ XFarter: 間
推 roger840410: 每一行都要註解型/* 有病啊！*/
推 Segal: 笑死，而且我還真看過4.
→ jeff666: 4就沒GIT在用的方法阿
推 ccnancy: // 不知道原因但拔掉這行會GG
推 v86861062: 真慘
推 Shawn5689: //主管說這bug不修 2024/12/25
推 XFarter: 其他種都值得噴兩句，就是第四種視情況還可以，尤其是很
→ XFarter: 可能被反覆重構的函數多了日期跟具體的更改內容還能省得
→ XFarter: 回去看 log
→ kamisanma: 聽同學說加不加其實差不多 一樣看不懂
推 TCPai: 7其實蠻好笑的
→ jcaosola: 跳去200k/月 的公司鬼故事就少很多了
→ kusotoripeko: 確定不是82k?
→ CP64: 4 還真的時不時會看到 雖然看的都是別的公司的
→ XFarter: 但這年頭都有像 cursor composer 這種自動更動註解甚至內
→ XFarter: 容的工具了 以後註不註解的問題應該會越來越少
→ XFarter: 反正一律經過 AI 修整成人話就對了
→ spfy: 4超重要好嗎 我的甲方想到就會把功能改回去 翻GIT太慢又太多
→ spfy: 直接用關鍵字搜尋到被註解的程式碼 //2015 客戶說要這功能
→ spfy: //2016 客戶說功能有問題取消 //2018客戶又說要這功能
推 kuninaka: 第四種真的還好
→ spfy: //2024客戶說這個功能是不是沒在用 幹
→ kuninaka: 不是每天都有一堆時間在那邊翻GIT HISTORY
→ kuninaka: 註解真的小事就是
推 alpho: 老一點的code真的會有日期署名
→ CP64: 不過 4 其實也可以編輯器搭 git blame 作到就是了
→ CP64: 前提是 commit message 的規範有到位
推 pokeyok: 能跑就好了 整天要讓所有人都看懂到底想幹嘛
推 Spartaa: 4很方便，尤其那種USER 需求每隔一段時間就會改一次的
推 engelba: 4 維護過沒有git 時代的code 都會這樣 而且還是sop…
→ engelba: 對了 就算是職訓仔起薪也有4萬 快逃喔
推 s207072s: //4上古神扣常常有
→ inte629l: 4我看過最早的時間是1998年
推 qd6590: 蛤 28K 直接陶 不要留念
推 felaray: 4有時候確實是需要的XD
推 ches51311: 之前測試有塞 0xc8763
→ spfy: 搞不好他是28k人民幣阿
推 silveryiris: 1到6都遇過，最討厭2，超級干擾
推 ap5552477: 還有縮排全改型，等你要抓戰犯 git blame 才發現
推 Haruna1998: 嗚嗚嗚我就是2 型 還幾乎每行都寫註解
推 Haruna1998: //! 後端說傳這樣給他 不要問我為什麼
推 Kfgwen: 笑了
推 a1982213: 不玩哽怎麼行
推 aaa1234136: 看過註解寫 奉XX指示修改此功能
推 tommy1113: 4 我在修2000年左右的程式很多這種的
噓 godhead: 連版控都不知道活該28k
推 CowBaoGan: 28k是美金嗎
推 vipTentyou: 最近合作的專案都是1的類型，而且是寫很爛的那種==
推 shallreturn: 如果我看到code有這種東西的話我一定殺人
推 chrisjeremy: 4還好 尤其是案子跑2、3年以上 版本紀錄幾百條 要找
→ chrisjeremy: 啥時改這裡的頗方便
→ k254369: 28k當然是鎂年薪
推 lav1147: 廢話型那個也太廢了吧XD  還有完全不懂版本控制的也很煩
→ rogerlarger: 4.我前公司有，某系統廠，但有在用git