PTT推薦

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

看板C_Chat標題Re: [閒聊] 寫code不加註解真的很顧人怨嗎作者
SkankHunt42
(凱子爸)
時間推噓59 推:60 噓:1 →:39

※ 引述《ianlin1216 (伊恩可可)》之銘言:
: 餓死抬頭
: https://i.imgur.com/3QcIsVN.jpeg

圖 寫code不加註解真的很顧人怨嗎
: 本魯不是資工系的啦
: 所以不知道寫程式不加註解會有多嚴重
: 想請問相關從業的鄉民
: 實務上遇到這種情況真的很賭爛嗎
: 乾五西恰

大家好 我月薪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留言評論
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 89.187.161.5 (日本)
PTT 網址

lucky041712/25 19:44還沒遇過加薪型

moe58458612/25 19:45還好我對這代碼有印象= =

shadow032612/25 19:45我沒點 那是瑞克搖嗎

lslayer12/25 19:456是什麼 幸運/不幸的程式碼喔

ilohoo12/25 19:46看到yt代碼就知道影片內容了

HJC666612/25 19:47亂放奇怪連結不會被幹嗎= =?

usoko12/25 19:47抱歉我是7 我塞了蠻多rickroll在mock data裡.....

p339853012/25 19:48有遇過1那種的 真的是浪費別人時間

ilohoo12/25 19:48那個代碼在github出現了九萬多次

steven3QXD12/25 19:48宅宅型是我..

usoko12/25 19:481那種的code review理論上就不可能會過了

negisan3912/25 19:4928k太低了吧塊逃

kingo232712/25 19:49超好笑你們寫程式的宅宅都這麼幽默嗎= =

devilkool12/25 19:49我喜歡在單元測試裡放宅宅梗

deflife12/25 19:49好希望可以遇到加薪型的

devilkool12/25 19:50理論上code review不會過,前提是要有review

kaj198312/25 19:50因為寫註解就是想讓別人看到啊

kaj198312/25 19:51愛怎麼寫就怎麼寫

usoko12/25 19:51push權限隨便開那當然是後果自負了 沒有PR誰知道你塞了什麼

usoko12/25 19:51垃圾到repo裡....

shadow032612/25 19:51所以其他6種code review會過嗎

kaj198312/25 19:51反正以後有人看到覺得不適合也會刪掉

harryron912/25 19:52第四個還好吧 嗚嗚嗚

usoko12/25 19:524根本連git都不會用所以不會出現 其他的會被刪光

YellowTiger12/25 19:566是三小啦 笑死

coronach12/25 19:58全世界的測試程式不知道有多少You shall not pass…總

coronach12/25 19:58覺得看過很多次

miyazakisun212/25 19:594 依公司規定更改的地方起頭跟結束的要寫改版日期

storym9437412/25 20:02哪家公司這樣規定 笑死

lanstype12/25 20:03如果真的是28k也太慘

xga00mex12/25 20:06我廢話型 多寫總比沒寫好 但還是有人能在我寫了的情況

xga00mex12/25 20:06還犯我寫的禁止事項

rizman2812/25 20:07Rickroll 笑死

Beltran12/25 20:07應該是28k鎂對吧

FCPo01167412/25 20:07有時候反而變寫太多,結果後續改的人懶的看就是了

Curapikt12/25 20:09超過直男型:錯誤訊息:,"主管說這種情況不會發生"。

Curapikt12/25 20:09結果真的發生了,第一次看到我真的快笑死www

gamixxxx12/25 20:09完了,宅宅型搓到我的笑點

smallreader12/25 20:13還沒點就知道是瑞克搖XD

richardz12/25 20:13我基本不太寫,除非太複雜

boooooood12/25 20:1328k是顧問吧 坐等領錢的

tsubasawolfy12/25 20:14AI型呢

Jameshunter12/25 20:15現在看到廢話型的十個有九個是ChatGPT寫的

Jameshunter12/25 20:15有些註解還會上下各空一行

jeremy798612/25 20:16我看到YT網址就知道是什麼了

XFarter12/25 20:27第四種還好吧 許多函數在重構或搬移的時候有可能會丟失最

XFarter12/25 20:27後的更改時間 這時候 git blame 可看不出來具體的修改時

XFarter12/25 20:27

roger84041012/25 20:27每一行都要註解型/* 有病啊!*/

Segal12/25 20:32笑死,而且我還真看過4.

jeff66612/25 20:344就沒GIT在用的方法阿

ccnancy12/25 20:35// 不知道原因但拔掉這行會GG

v8686106212/25 20:35真慘

Shawn568912/25 20:39//主管說這bug不修 2024/12/25

XFarter12/25 20:41其他種都值得噴兩句,就是第四種視情況還可以,尤其是很

XFarter12/25 20:41可能被反覆重構的函數多了日期跟具體的更改內容還能省得

XFarter12/25 20:41回去看 log

kamisanma12/25 20:42聽同學說加不加其實差不多 一樣看不懂

TCPai12/25 20:537其實蠻好笑的

jcaosola12/25 21:01跳去200k/月 的公司鬼故事就少很多了

kusotoripeko12/25 21:02確定不是82k?

CP6412/25 21:084 還真的時不時會看到 雖然看的都是別的公司的

XFarter12/25 21:10但這年頭都有像 cursor composer 這種自動更動註解甚至內

XFarter12/25 21:10容的工具了 以後註不註解的問題應該會越來越少

XFarter12/25 21:10反正一律經過 AI 修整成人話就對了

spfy12/25 21:134超重要好嗎 我的甲方想到就會把功能改回去 翻GIT太慢又太多

spfy12/25 21:14直接用關鍵字搜尋到被註解的程式碼 //2015 客戶說要這功能

spfy12/25 21:14//2016 客戶說功能有問題取消 //2018客戶又說要這功能

kuninaka12/25 21:15第四種真的還好

spfy12/25 21:15//2024客戶說這個功能是不是沒在用 幹

kuninaka12/25 21:16不是每天都有一堆時間在那邊翻GIT HISTORY

kuninaka12/25 21:16註解真的小事就是

alpho12/25 21:20老一點的code真的會有日期署名

CP6412/25 21:22不過 4 其實也可以編輯器搭 git blame 作到就是了

CP6412/25 21:23前提是 commit message 的規範有到位

pokeyok12/25 21:23能跑就好了 整天要讓所有人都看懂到底想幹嘛

Spartaa12/25 21:254很方便,尤其那種USER 需求每隔一段時間就會改一次的

engelba12/25 21:254 維護過沒有git 時代的code 都會這樣 而且還是sop…

engelba12/25 21:26對了 就算是職訓仔起薪也有4萬 快逃喔

s207072s12/25 21:31//4上古神扣常常有

inte629l12/25 21:314我看過最早的時間是1998年

qd659012/25 21:34蛤 28K 直接陶 不要留念

felaray12/25 21:434有時候確實是需要的XD

ches5131112/25 21:47之前測試有塞 0xc8763

spfy12/25 21:47搞不好他是28k人民幣阿

silveryiris12/25 21:471到6都遇過,最討厭2,超級干擾

ap555247712/25 21:58還有縮排全改型,等你要抓戰犯 git blame 才發現

Haruna199812/25 22:11嗚嗚嗚我就是2 型 還幾乎每行都寫註解

Haruna199812/25 22:15//! 後端說傳這樣給他 不要問我為什麼

Kfgwen12/25 22:26笑了

a198221312/25 22:31不玩哽怎麼行

aaa123413612/25 23:33看過註解寫 奉XX指示修改此功能

tommy111312/25 23:444 我在修2000年左右的程式很多這種的

godhead12/26 00:00連版控都不知道活該28k

CowBaoGan12/26 00:5128k是美金嗎

vipTentyou12/26 01:05最近合作的專案都是1的類型,而且是寫很爛的那種==

shallreturn12/26 01:44如果我看到code有這種東西的話我一定殺人

chrisjeremy12/26 02:114還好 尤其是案子跑2、3年以上 版本紀錄幾百條 要找

chrisjeremy12/26 02:11啥時改這裡的頗方便

k25436912/26 03:2528k當然是鎂年薪