※ 本文轉寄自 ptt.cc 更新時間: 2024-12-25 21:48:37
看板 C_Chat
作者 標題 Re: [閒聊] 寫code不加註解真的很顧人怨嗎
時間 Wed Dec 25 19:42:15 2024
※ 引述《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 (日本)
※ 作者: SkankHunt42 2024-12-25 19:42:15
※ 文章代碼(AID): #1dQ--PtA (C_Chat)
※ 文章網址: https://www.ptt.cc/bbs/C_Chat/M.1735126937.A.DCA.html
推 : 還沒遇過加薪型1F 12/25 19:44
推 : 還好我對這代碼有印象= =2F 12/25 19:45
推 : 我沒點 那是瑞克搖嗎3F 12/25 19:45
推 : 6是什麼 幸運/不幸的程式碼喔4F 12/25 19:45
推 : 看到yt代碼就知道影片內容了5F 12/25 19:46
推 : 亂放奇怪連結不會被幹嗎= =?6F 12/25 19:47
推 : 抱歉我是7 我塞了蠻多rickroll在mock data裡.....7F 12/25 19:47
→ : 有遇過1那種的 真的是浪費別人時間8F 12/25 19:48
→ : 那個代碼在github出現了九萬多次9F 12/25 19:48
推 : 宅宅型是我..10F 12/25 19:48
→ : 1那種的code review理論上就不可能會過了11F 12/25 19:48
推 : 28k太低了吧塊逃12F 12/25 19:49
推 : 超好笑你們寫程式的宅宅都這麼幽默嗎= =13F 12/25 19:49
推 : 我喜歡在單元測試裡放宅宅梗14F 12/25 19:49
推 : 好希望可以遇到加薪型的15F 12/25 19:49
→ : 理論上code review不會過，前提是要有review16F 12/25 19:50
推 : 因為寫註解就是想讓別人看到啊17F 12/25 19:50
→ : 愛怎麼寫就怎麼寫
→ : 愛怎麼寫就怎麼寫
推 : push權限隨便開那當然是後果自負了 沒有PR誰知道你塞了什麼19F 12/25 19:51
→ : 垃圾到repo裡....
→ : 垃圾到repo裡....
推 : 所以其他6種code review會過嗎21F 12/25 19:51
→ : 反正以後有人看到覺得不適合也會刪掉22F 12/25 19:51
→ : 第四個還好吧 嗚嗚嗚23F 12/25 19:52
→ : 4根本連git都不會用所以不會出現 其他的會被刪光24F 12/25 19:52
推 : 6是三小啦 笑死25F 12/25 19:56
推 : 全世界的測試程式不知道有多少You shall not pass…總26F 12/25 19:58
→ : 覺得看過很多次
→ : 覺得看過很多次
推 : 4 依公司規定更改的地方起頭跟結束的要寫改版日期28F 12/25 19:59
推 : 哪家公司這樣規定 笑死29F 12/25 20:02
推 : 如果真的是28k也太慘30F 12/25 20:03
→ : 我廢話型 多寫總比沒寫好 但還是有人能在我寫了的情況31F 12/25 20:06
→ : 還犯我寫的禁止事項
→ : 還犯我寫的禁止事項
推 : Rickroll 笑死33F 12/25 20:07
推 : 應該是28k鎂對吧34F 12/25 20:07
推 : 有時候反而變寫太多，結果後續改的人懶的看就是了35F 12/25 20:07
推 : 超過直男型：錯誤訊息:，"主管說這種情況不會發生"。36F 12/25 20:09
→ : 結果真的發生了，第一次看到我真的快笑死www
→ : 結果真的發生了，第一次看到我真的快笑死www
推 : 完了，宅宅型搓到我的笑點38F 12/25 20:09
推 : 還沒點就知道是瑞克搖XD39F 12/25 20:13
推 : 我基本不太寫，除非太複雜40F 12/25 20:13
推 : 28k是顧問吧 坐等領錢的41F 12/25 20:13
推 : AI型呢42F 12/25 20:14
推 : 現在看到廢話型的十個有九個是ChatGPT寫的43F 12/25 20:15
→ : 有些註解還會上下各空一行
→ : 有些註解還會上下各空一行
推 : 我看到YT網址就知道是什麼了45F 12/25 20:16
推 : 第四種還好吧 許多函數在重構或搬移的時候有可能會丟失最46F 12/25 20:27
→ : 後的更改時間 這時候 git blame 可看不出來具體的修改時
→ : 間
→ : 後的更改時間 這時候 git blame 可看不出來具體的修改時
→ : 間
推 : 每一行都要註解型/* 有病啊！*/49F 12/25 20:27
推 : 笑死，而且我還真看過4.50F 12/25 20:32
→ : 4就沒GIT在用的方法阿51F 12/25 20:34
推 : // 不知道原因但拔掉這行會GG52F 12/25 20:35
推 : 真慘53F 12/25 20:35
推 : //主管說這bug不修 2024/12/2554F 12/25 20:39
推 : 其他種都值得噴兩句，就是第四種視情況還可以，尤其是很55F 12/25 20:41
→ : 可能被反覆重構的函數多了日期跟具體的更改內容還能省得
→ : 回去看 log
→ : 可能被反覆重構的函數多了日期跟具體的更改內容還能省得
→ : 回去看 log
→ : 聽同學說加不加其實差不多 一樣看不懂58F 12/25 20:42
推 : 7其實蠻好笑的59F 12/25 20:53
→ : 跳去200k/月 的公司鬼故事就少很多了60F 12/25 21:01
→ : 確定不是82k?61F 12/25 21:02
→ : 4 還真的時不時會看到 雖然看的都是別的公司的62F 12/25 21:08
→ : 但這年頭都有像 cursor composer 這種自動更動註解甚至內63F 12/25 21:10
→ : 容的工具了 以後註不註解的問題應該會越來越少
→ : 反正一律經過 AI 修整成人話就對了
→ : 容的工具了 以後註不註解的問題應該會越來越少
→ : 反正一律經過 AI 修整成人話就對了
→ : 4超重要好嗎 我的甲方想到就會把功能改回去 翻GIT太慢又太多66F 12/25 21:13
→ : 直接用關鍵字搜尋到被註解的程式碼 //2015 客戶說要這功能
→ : //2016 客戶說功能有問題取消 //2018客戶又說要這功能
→ : 直接用關鍵字搜尋到被註解的程式碼 //2015 客戶說要這功能
→ : //2016 客戶說功能有問題取消 //2018客戶又說要這功能
推 : 第四種真的還好69F 12/25 21:15
→ : //2024客戶說這個功能是不是沒在用 幹70F 12/25 21:15
→ : 不是每天都有一堆時間在那邊翻GIT HISTORY71F 12/25 21:16
→ : 註解真的小事就是
→ : 註解真的小事就是
推 : 老一點的code真的會有日期署名73F 12/25 21:20
→ : 不過 4 其實也可以編輯器搭 git blame 作到就是了74F 12/25 21:22
→ : 前提是 commit message 的規範有到位
→ : 前提是 commit message 的規範有到位
推 : 能跑就好了 整天要讓所有人都看懂到底想幹嘛76F 12/25 21:23
推 : 4很方便，尤其那種USER 需求每隔一段時間就會改一次的77F 12/25 21:25
推 : 4 維護過沒有git 時代的code 都會這樣 而且還是sop…78F 12/25 21:25
→ : 對了 就算是職訓仔起薪也有4萬 快逃喔
→ : 對了 就算是職訓仔起薪也有4萬 快逃喔
推 : //4上古神扣常常有80F 12/25 21:31
→ : 4我看過最早的時間是1998年81F 12/25 21:31
推 : 蛤 28K 直接陶 不要留念82F 12/25 21:34
推 : 4有時候確實是需要的XD83F 12/25 21:43
--
※ 看板: ACG 文章推薦值: 0 目前人氣: 7 累積人氣: 775
作者 SkankHunt42 的最新發文:
![]()
大家好 我月薪28k軟體工程師啦 我的觀察齁 程式設計師有好幾種類型 1. 無口型 做了很奇怪的事也不註解，commit也找不到原因 等到哪個有重構強迫症的改壞程式以後才發現原來看似很奇 怪很醜的寫 …83F 47推- 23F 12推
- 27F 19推 1噓
- 22F 9推
點此顯示更多發文記錄
回列表(←)
分享