看板 C_Chat
作者 SkankHunt42 (凱子爸)
標題 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
※ 同主題文章:
Re: [閒聊] 寫code不加註解真的很顧人怨嗎
12-25 19:42 SkankHunt42.
lucky0417: 還沒遇過加薪型1F 12/25 19:44
moe584586: 還好我對這代碼有印象= =2F 12/25 19:45
shadow0326: 我沒點 那是瑞克搖嗎3F 12/25 19:45
lslayer: 6是什麼 幸運/不幸的程式碼喔4F 12/25 19:45
ilohoo: 看到yt代碼就知道影片內容了5F 12/25 19:46
HJC6666: 亂放奇怪連結不會被幹嗎= =?6F 12/25 19:47
usoko: 抱歉我是7 我塞了蠻多rickroll在mock data裡.....7F 12/25 19:47
p3398530: 有遇過1那種的 真的是浪費別人時間8F 12/25 19:48
ilohoo: 那個代碼在github出現了九萬多次9F 12/25 19:48
steven3QXD: 宅宅型是我..10F 12/25 19:48
usoko: 1那種的code review理論上就不可能會過了11F 12/25 19:48
negisan39: 28k太低了吧塊逃12F 12/25 19:49
kingo2327: 超好笑你們寫程式的宅宅都這麼幽默嗎= =13F 12/25 19:49
devilkool: 我喜歡在單元測試裡放宅宅梗14F 12/25 19:49
deflife: 好希望可以遇到加薪型的15F 12/25 19:49
devilkool: 理論上code review不會過,前提是要有review16F 12/25 19:50
kaj1983: 因為寫註解就是想讓別人看到啊
愛怎麼寫就怎麼寫17F 12/25 19:50
usoko: push權限隨便開那當然是後果自負了 沒有PR誰知道你塞了什麼垃圾到repo裡....19F 12/25 19:51
shadow0326: 所以其他6種code review會過嗎21F 12/25 19:51
kaj1983: 反正以後有人看到覺得不適合也會刪掉22F 12/25 19:51
harryron9: 第四個還好吧 嗚嗚嗚23F 12/25 19:52
usoko: 4根本連git都不會用所以不會出現 其他的會被刪光24F 12/25 19:52
YellowTiger: 6是三小啦 笑死25F 12/25 19:56
coronach: 全世界的測試程式不知道有多少You shall not pass…總覺得看過很多次26F 12/25 19:58
miyazakisun2: 4 依公司規定更改的地方起頭跟結束的要寫改版日期28F 12/25 19:59
storym94374: 哪家公司這樣規定 笑死29F 12/25 20:02
lanstype: 如果真的是28k也太慘30F 12/25 20:03
xga00mex: 我廢話型 多寫總比沒寫好 但還是有人能在我寫了的情況還犯我寫的禁止事項31F 12/25 20:06
rizman28: Rickroll 笑死33F 12/25 20:07
Beltran: 應該是28k鎂對吧34F 12/25 20:07
FCPo011674: 有時候反而變寫太多,結果後續改的人懶的看就是了35F 12/25 20:07
Curapikt: 超過直男型:錯誤訊息:,"主管說這種情況不會發生"。
結果真的發生了,第一次看到我真的快笑死www36F 12/25 20:09
gamixxxx: 完了,宅宅型搓到我的笑點38F 12/25 20:09
smallreader: 還沒點就知道是瑞克搖XD39F 12/25 20:13
richardz: 我基本不太寫,除非太複雜40F 12/25 20:13
boooooood: 28k是顧問吧   坐等領錢的41F 12/25 20:13
tsubasawolfy: AI型呢42F 12/25 20:14
Jameshunter: 現在看到廢話型的十個有九個是ChatGPT寫的
有些註解還會上下各空一行43F 12/25 20:15
jeremy7986: 我看到YT網址就知道是什麼了45F 12/25 20:16
XFarter: 第四種還好吧 許多函數在重構或搬移的時候有可能會丟失最後的更改時間 這時候 git blame 可看不出來具體的修改時46F 12/25 20:27
roger840410: 每一行都要註解型/* 有病啊!*/49F 12/25 20:27
Segal: 笑死,而且我還真看過4.50F 12/25 20:32
jeff666: 4就沒GIT在用的方法阿51F 12/25 20:34
ccnancy: // 不知道原因但拔掉這行會GG52F 12/25 20:35
v86861062: 真慘53F 12/25 20:35
Shawn5689: //主管說這bug不修 2024/12/2554F 12/25 20:39
XFarter: 其他種都值得噴兩句,就是第四種視情況還可以,尤其是很可能被反覆重構的函數多了日期跟具體的更改內容還能省得回去看 log55F 12/25 20:41
kamisanma: 聽同學說加不加其實差不多 一樣看不懂58F 12/25 20:42
TCPai: 7其實蠻好笑的59F 12/25 20:53
jcaosola: 跳去200k/月 的公司鬼故事就少很多了60F 12/25 21:01
kusotoripeko: 確定不是82k?61F 12/25 21:02
CP64: 4 還真的時不時會看到 雖然看的都是別的公司的62F 12/25 21:08
XFarter: 但這年頭都有像 cursor composer 這種自動更動註解甚至內容的工具了 以後註不註解的問題應該會越來越少
反正一律經過 AI 修整成人話就對了63F 12/25 21:10
spfy: 4超重要好嗎 我的甲方想到就會把功能改回去 翻GIT太慢又太多直接用關鍵字搜尋到被註解的程式碼 //2015 客戶說要這功能//2016 客戶說功能有問題取消 //2018客戶又說要這功能66F 12/25 21:13
kuninaka: 第四種真的還好69F 12/25 21:15
spfy: //2024客戶說這個功能是不是沒在用 幹70F 12/25 21:15
kuninaka: 不是每天都有一堆時間在那邊翻GIT HISTORY
註解真的小事就是71F 12/25 21:16
alpho: 老一點的code真的會有日期署名73F 12/25 21:20
CP64: 不過 4 其實也可以編輯器搭 git blame 作到就是了
前提是 commit message 的規範有到位74F 12/25 21:22
pokeyok: 能跑就好了 整天要讓所有人都看懂到底想幹嘛76F 12/25 21:23
Spartaa: 4很方便,尤其那種USER 需求每隔一段時間就會改一次的77F 12/25 21:25
engelba: 4 維護過沒有git 時代的code 都會這樣 而且還是sop…
對了 就算是職訓仔起薪也有4萬 快逃喔78F 12/25 21:25
s207072s: //4上古神扣常常有80F 12/25 21:31
inte629l: 4我看過最早的時間是1998年81F 12/25 21:31
qd6590: 蛤 28K 直接陶 不要留念82F 12/25 21:34
felaray: 4有時候確實是需要的XD83F 12/25 21:43

--