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

作者: SkankHunt42 (me so horny)   2024-12-25 19:42:15
※ 引述《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
作者: lucky0417 (L.W)   2024-12-25 19:44:00
還沒遇過加薪型
作者: moe584586 (阿米巴原蟲)   2024-12-25 19:45:00
還好我對這代碼有印象= =
作者: shadow0326 (非議)   2024-12-25 19:45:00
我沒點 那是瑞克搖嗎
作者: lslayer   2024-12-25 19:45:00
6是什麼 幸運/不幸的程式碼喔
作者: ilohoo (ilohoo)   2024-12-25 19:46:00
看到yt代碼就知道影片內容了
作者: HJC6666 (帕修)   2024-12-25 19:47:00
亂放奇怪連結不會被幹嗎= =?
作者: usoko (time to face reality)   2024-12-25 19:47:00
抱歉我是7 我塞了蠻多rickroll在mock data裡.....
作者: p3398530 (活著就好)   2024-12-25 19:48:00
有遇過1那種的 真的是浪費別人時間
作者: ilohoo (ilohoo)   2024-12-25 19:48:00
那個代碼在github出現了九萬多次
作者: steven3QXD (駿)   2024-12-25 19:48:00
宅宅型是我..
作者: usoko (time to face reality)   2024-12-25 19:48:00
1那種的code review理論上就不可能會過了
作者: negisan39 (The建)   2024-12-25 19:49:00
28k太低了吧塊逃
作者: kingo2327 (NakedGenius)   2024-12-25 19:49:00
超好笑你們寫程式的宅宅都這麼幽默嗎= =
作者: devilkool (對貓毛過敏的貓控)   2024-12-25 19:49:00
我喜歡在單元測試裡放宅宅梗
作者: deflife (無極而生)   2024-12-25 19:49:00
好希望可以遇到加薪型的
作者: devilkool (對貓毛過敏的貓控)   2024-12-25 19:50:00
理論上code review不會過,前提是要有review
作者: kaj1983   2024-12-25 19:50:00
因為寫註解就是想讓別人看到啊愛怎麼寫就怎麼寫
作者: usoko (time to face reality)   2024-12-25 19:51:00
push權限隨便開那當然是後果自負了 沒有PR誰知道你塞了什麼垃圾到repo裡....
作者: shadow0326 (非議)   2024-12-25 19:51:00
所以其他6種code review會過嗎
作者: kaj1983   2024-12-25 19:51:00
反正以後有人看到覺得不適合也會刪掉
作者: harryron9 (兩個世界)   2024-12-25 19:52:00
第四個還好吧 嗚嗚嗚
作者: usoko (time to face reality)   2024-12-25 19:52:00
4根本連git都不會用所以不會出現 其他的會被刪光
作者: YellowTiger (YellowTiger)   2024-12-25 19:56:00
6是三小啦 笑死
作者: coronach (...)   2024-12-25 19:58:00
全世界的測試程式不知道有多少You shall not pass…總覺得看過很多次
作者: miyazakisun2 (hidetaka)   2024-12-25 19:59:00
4 依公司規定更改的地方起頭跟結束的要寫改版日期
作者: storym94374 (瑪利歐)   2024-12-25 20:02:00
哪家公司這樣規定 笑死
作者: lanstype (lanstype)   2024-12-25 20:03:00
如果真的是28k也太慘
作者: xga00mex (七祈綺契)   2024-12-25 20:06:00
我廢話型 多寫總比沒寫好 但還是有人能在我寫了的情況還犯我寫的禁止事項
作者: rizman28 (栗子)   2024-12-25 20:07:00
Rickroll 笑死
作者: Beltran (グル≡崩壊)   2024-12-25 20:07:00
應該是28k鎂對吧
作者: FCPo011674 (文)   2024-12-25 20:07:00
有時候反而變寫太多,結果後續改的人懶的看就是了
作者: Curapikt (StarLight Breaker!!)   2024-12-25 20:09:00
超過直男型:錯誤訊息:,"主管說這種情況不會發生"。結果真的發生了,第一次看到我真的快笑死www
作者: gamixxxx (維)   2024-12-25 20:09:00
完了,宅宅型搓到我的笑點
作者: smallreader (小讀者)   2024-12-25 20:13:00
還沒點就知道是瑞克搖XD
作者: richardz (卍罪愛卍)   2024-12-25 20:13:00
我基本不太寫,除非太複雜
作者: boooooood (減肥中勿擾)   2024-12-25 20:13:00
28k是顧問吧 坐等領錢的
作者: tsubasawolfy (悠久の翼)   2024-12-25 20:14:00
AI型呢
作者: Jameshunter (幻劍)   2024-12-25 20:15:00
現在看到廢話型的十個有九個是ChatGPT寫的有些註解還會上下各空一行
作者: jeremy7986 (影子-shadow★)   2024-12-25 20:16:00
我看到YT網址就知道是什麼了
作者: XFarter (劈哩啪啦碰碰碰)   2024-12-25 20:27:00
第四種還好吧 許多函數在重構或搬移的時候有可能會丟失最後的更改時間 這時候 git blame 可看不出來具體的修改時間
作者: roger840410 (roger)   2024-12-25 20:27:00
每一行都要註解型/* 有病啊!*/
作者: Segal (Dino)   2024-12-25 20:32:00
笑死,而且我還真看過4.
作者: jeff666   2024-12-25 20:34:00
4就沒GIT在用的方法阿
作者: ccnancy (茶茶茶)   2024-12-25 20:35:00
// 不知道原因但拔掉這行會GG
作者: v86861062 (數字人:3)   2024-12-25 20:35:00
真慘
作者: Shawn5689 (Sion)   2024-12-25 20:39:00
//主管說這bug不修 2024/12/25
作者: XFarter (劈哩啪啦碰碰碰)   2024-12-25 20:41:00
其他種都值得噴兩句,就是第四種視情況還可以,尤其是很可能被反覆重構的函數多了日期跟具體的更改內容還能省得回去看 log
作者: kamisanma (異議あり!)   2024-12-25 20:42:00
聽同學說加不加其實差不多 一樣看不懂
作者: TCPai (荒野遊俠)   2024-12-25 20:53:00
7其實蠻好笑的
作者: jcaosola (紙袋)   2024-12-25 21:01:00
跳去200k/月 的公司鬼故事就少很多了
作者: kusotoripeko (好油喔)   2024-12-25 21:02:00
確定不是82k?
作者: CP64 (( ̄▽ ̄#)﹏﹏)   2024-12-25 21:08:00
4 還真的時不時會看到 雖然看的都是別的公司的
作者: XFarter (劈哩啪啦碰碰碰)   2024-12-25 21:10:00
但這年頭都有像 cursor composer 這種自動更動註解甚至內容的工具了 以後註不註解的問題應該會越來越少反正一律經過 AI 修整成人話就對了
作者: spfy (spfy)   2024-12-25 21:13:00
4超重要好嗎 我的甲方想到就會把功能改回去 翻GIT太慢又太多直接用關鍵字搜尋到被註解的程式碼 //2015 客戶說要這功能//2016 客戶說功能有問題取消 //2018客戶又說要這功能
作者: kuninaka   2024-12-25 21:15:00
第四種真的還好
作者: spfy (spfy)   2024-12-25 21:15:00
//2024客戶說這個功能是不是沒在用 幹
作者: kuninaka   2024-12-25 21:16:00
不是每天都有一堆時間在那邊翻GIT HISTORY註解真的小事就是
作者: alpho (Whyyyyy)   2024-12-25 21:20:00
老一點的code真的會有日期署名
作者: CP64 (( ̄▽ ̄#)﹏﹏)   2024-12-25 21:22:00
不過 4 其實也可以編輯器搭 git blame 作到就是了前提是 commit message 的規範有到位
作者: pokeyok (XDX)   2024-12-25 21:23:00
能跑就好了 整天要讓所有人都看懂到底想幹嘛
作者: Spartaa (CaDaoIn)   2024-12-25 21:25:00
4很方便,尤其那種USER 需求每隔一段時間就會改一次的
作者: engelba (香腸四郎)   2024-12-25 21:25:00
4 維護過沒有git 時代的code 都會這樣 而且還是sop…對了 就算是職訓仔起薪也有4萬 快逃喔
作者: s207072s (漁夫)   2024-12-25 21:31:00
//4上古神扣常常有
作者: inte629l   2024-12-25 21:31:00
4我看過最早的時間是1998年
作者: qd6590 (說好吃)   2024-12-25 21:34:00
蛤 28K 直接陶 不要留念
作者: felaray (傲嬌魚)   2024-12-25 21:43:00
4有時候確實是需要的XD
作者: ches51311 (游泳迪)   2024-12-25 21:47:00
之前測試有塞 0xc8763
作者: spfy (spfy)   2024-12-25 21:47:00
搞不好他是28k人民幣阿
作者: silveryiris (= =)   2024-12-25 21:47:00
1到6都遇過,最討厭2,超級干擾
作者: ap5552477 (VagrantPi)   2024-12-25 21:58:00
還有縮排全改型,等你要抓戰犯 git blame 才發現
作者: Haruna1998 (無聲雨)   2024-12-25 22:11:00
嗚嗚嗚我就是2 型 還幾乎每行都寫註解//! 後端說傳這樣給他 不要問我為什麼
作者: Kfgwen (KF)   2024-12-25 22:26:00
笑了
作者: a1982213 (Hasta la vesta!)   2024-12-25 22:31:00
不玩哽怎麼行
作者: aaa1234136 (淡水活魚)   2024-12-25 23:33:00
看過註解寫 奉XX指示修改此功能

Links booklink

Contact Us: admin [ a t ] ucptt.com