Re: [閒聊] 寫code不加註解真的很顧人怨嗎
※ 引述《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
--
還沒遇過加薪型
還好我對這代碼有印象= =
我沒點 那是瑞克搖嗎
6是什麼 幸運/不幸的程式碼喔
看到yt代碼就知道影片內容了
亂放奇怪連結不會被幹嗎= =?
抱歉我是7 我塞了蠻多rickroll在mock data裡.....
有遇過1那種的 真的是浪費別人時間
那個代碼在github出現了九萬多次
宅宅型是我..
1那種的code review理論上就不可能會過了
28k太低了吧塊逃
超好笑你們寫程式的宅宅都這麼幽默嗎= =
我喜歡在單元測試裡放宅宅梗
好希望可以遇到加薪型的
理論上code review不會過,前提是要有review
因為寫註解就是想讓別人看到啊
愛怎麼寫就怎麼寫
push權限隨便開那當然是後果自負了 沒有PR誰知道你塞了什麼
垃圾到repo裡....
所以其他6種code review會過嗎
反正以後有人看到覺得不適合也會刪掉
第四個還好吧 嗚嗚嗚
4根本連git都不會用所以不會出現 其他的會被刪光
6是三小啦 笑死
全世界的測試程式不知道有多少You shall not pass…總
覺得看過很多次
4 依公司規定更改的地方起頭跟結束的要寫改版日期
哪家公司這樣規定 笑死
如果真的是28k也太慘
我廢話型 多寫總比沒寫好 但還是有人能在我寫了的情況
還犯我寫的禁止事項
Rickroll 笑死
應該是28k鎂對吧
有時候反而變寫太多,結果後續改的人懶的看就是了
超過直男型:錯誤訊息:,"主管說這種情況不會發生"。
結果真的發生了,第一次看到我真的快笑死www
完了,宅宅型搓到我的笑點
還沒點就知道是瑞克搖XD
我基本不太寫,除非太複雜
28k是顧問吧 坐等領錢的
AI型呢
現在看到廢話型的十個有九個是ChatGPT寫的
有些註解還會上下各空一行
我看到YT網址就知道是什麼了
第四種還好吧 許多函數在重構或搬移的時候有可能會丟失最
後的更改時間 這時候 git blame 可看不出來具體的修改時
間
每一行都要註解型/* 有病啊!*/
笑死,而且我還真看過4.
4就沒GIT在用的方法阿
// 不知道原因但拔掉這行會GG
真慘
//主管說這bug不修 2024/12/25
其他種都值得噴兩句,就是第四種視情況還可以,尤其是很
可能被反覆重構的函數多了日期跟具體的更改內容還能省得
回去看 log
聽同學說加不加其實差不多 一樣看不懂
7其實蠻好笑的
跳去200k/月 的公司鬼故事就少很多了
確定不是82k?
4 還真的時不時會看到 雖然看的都是別的公司的
但這年頭都有像 cursor composer 這種自動更動註解甚至內
容的工具了 以後註不註解的問題應該會越來越少
反正一律經過 AI 修整成人話就對了
4超重要好嗎 我的甲方想到就會把功能改回去 翻GIT太慢又太多
直接用關鍵字搜尋到被註解的程式碼 //2015 客戶說要這功能
//2016 客戶說功能有問題取消 //2018客戶又說要這功能
第四種真的還好
//2024客戶說這個功能是不是沒在用 幹
不是每天都有一堆時間在那邊翻GIT HISTORY
註解真的小事就是
老一點的code真的會有日期署名
不過 4 其實也可以編輯器搭 git blame 作到就是了
前提是 commit message 的規範有到位
能跑就好了 整天要讓所有人都看懂到底想幹嘛
4很方便,尤其那種USER 需求每隔一段時間就會改一次的
4 維護過沒有git 時代的code 都會這樣 而且還是sop…
對了 就算是職訓仔起薪也有4萬 快逃喔
//4上古神扣常常有
4我看過最早的時間是1998年
蛤 28K 直接陶 不要留念
4有時候確實是需要的XD
之前測試有塞 0xc8763
搞不好他是28k人民幣阿
1到6都遇過,最討厭2,超級干擾
還有縮排全改型,等你要抓戰犯 git blame 才發現
嗚嗚嗚我就是2 型 還幾乎每行都寫註解
//! 後端說傳這樣給他 不要問我為什麼
笑了
不玩哽怎麼行
看過註解寫 奉XX指示修改此功能
4 我在修2000年左右的程式很多這種的
連版控都不知道活該28k
28k是美金嗎
最近合作的專案都是1的類型,而且是寫很爛的那種==
如果我看到code有這種東西的話我一定殺人
4還好 尤其是案子跑2、3年以上 版本紀錄幾百條 要找
啥時改這裡的頗方便
28k當然是鎂年薪
爆
首Po餓死抬頭 本魯不是資工系的啦 所以不知道寫程式不加註解會有多嚴重 想請問相關從業的鄉民8
最好的作法是 盡量把程式寫得清楚簡單易懂好理解 這樣就不需要加註解了 註解是拿來用在解釋特殊情況 也就是30
以下是根據本魯碼農自己的經驗,絕大部份參考Clean Code這本書,我自己是將這本書奉為 圭臬,不過我也知道很多人反對書裡的一些看法,所以聽聽就好 首先一個最大的原則就是程式碼必須好懂,因為它同時是寫給機器跟人看的,好懂是可擴充 性跟可維護性的必要,是程式碼無比重要的基石 推文有人說程式碼沒有註解的話十年後的自己會無法理解,實際上根據我自己的經驗如果我21
真的有這麼奇葩的註解嗎 上 code 前不是都會做 code review 嗎 現在很多工具除了會做 style check,commit message 之外, 甚至有些工具會檢查註解是否符合格式吧 這種亂上 code 真的不會被幹到起飛嗎
51
[心得] 好的註解是解釋為何需要這段 code轉自推特 Add comments about WHY code exists, not what it does. The code is right there, we know what it does. 註解應該用來解釋這段 code 的背景需求/含意,35
[討論] 重構跟kpi的考量假設以下情境 有個功能A、B都會用到相同邏輯,且有兩份重覆的code (沒有unit test保護,而且年久失修 要加入unit test會需要更多時程) 現在要加入C,也會用到相同邏輯 身為合格的工程師 應該會把ABC重覆的部份提取出來26
[問卦] 程式碼中有簡體字註解的問題是什麼?各位駐八卦版工程師大家好 我朋友之前幫老闆做專案啊 在寫網頁前端,其中JavaScript的部份好像不太會寫 跑去對岸知名的網註CSDN直接複製程式碼來使用 沒想到交付客戶後,被客戶抓包裡面有簡體字的註解29
Re: [心得] 好的註解是解釋為何需要這段 code上週在重構某段程式碼時,其中一位同事在 code review 中建議把某個註解刪掉,另一 個同事看到這個評論時,在下面留了言說他認為不應該刪掉,於是我們就拉了一個小討論 ,聊在程式碼中寫註解這件事。 因為這個經驗,我回去重翻史丹佛電腦科學教授 John Ousterhout 寫的《A Philosophy of Software Design》一書,並整理了筆記。該教授的觀點是認為程式碼寫註解有很多好24
Re: [討論] 怎麼克制不想教白目同事的衝動原PO還好 只要壓制住教他的衝動就好 有沒有遇過同事一開始很熱情的請教你一些基本到不行的問題 (ex static 是什麼 什麼時候用 泛型怎樣怎樣的 還說他很想進步,只是沒時間(讓人白眼的藉口14
Re: [討論] 用AI寫code產生的疑問其實很多新技術在早期和成熟後相比你會感覺他的應用是完全顛覆最初想法的 例如 web 仔最熟稔的 web 好了,網路泡沫時代前大家對電子商務 的觀點是在網路上的一個廣告頁,每個網站就像一間街邊店一樣,透過網址 這串虛擬地址你可以造訪網路上的任何一間店,找到你要的資訊,更容易媒合實體交易 當時的 web 就是一本電話簿的概念5
Re: [問卦] chatGPT是不是會消滅一堆文組職業?現在 vs code 已經可以整合 GPT-3 的 API 了。 直接選擇一段程式碼,讓 AI 自動生成註解; 或是反過來,先寫註解讓 AI 產生程式。 也可以直接跟AI聊天。 不分文理組,大家都可以洗洗睡了。5
Re: [新聞] 國慶官網爆是中國人設計?程式註解驚見本肥覺得因該不是中國人設計的 小肥我也是程式設計師,有時候懶得動腦的時候就會上網爬爬文 複製貼上複製貼上,一個懶惰就會忘記把註解刪掉 所以應該是我們的開發者是碼農,不是中國開發者 另外告訴大家一個小知識~不要小看碼農喔!X
[問卦] 愛台覺青工程師會拒絕抄中國的程式碼嗎剛剛看到有人爆掛才想到 真正愛台灣的覺青除了打高端之外 如果剛好身份又是工程師 那麼寫程式時 會刻意避開中國人寫的程式碼嗎?
爆
[dei] 迪士尼刪除跨性別內容 不再參與政治活動94
[MyGo] 欸笑死人欸55
[問題] 動漫有沒有教會過你什麼哲理?18
[MyGo] 急 邦邦其他系列值得先看嗎?16
[蔚藍] 今日壽星-白洲 アズサ55
[MyGO]愛爽 夜景39
[MyGo] 一個樂團沒有鋼琴真的會差很多嗎87
[討論] 台北駿河屋的徽章是要賣給誰13
[閒聊] 重看落第騎士動畫 一刀羅剎還是蠻帥的20
[閒聊] 最近p站發生的留言攻擊事件10
Re: [金毛] 純情大熊色情兔8
[閒聊] 貓貓為啥不會得梅毒7
[閒聊] 無腦巨人的牙齒怎麼整齊。。17
[閒聊] 日本有像西洽這樣的地方嗎?25
[大車] 姐姐搶先拿到5090過聖誕24
Re: [LL] LoveLive各團粉絲無法引流?10
[妮姬] 聖誕Doro9
[提名] 綾瀨沙季/義妹生活5
[閒聊] 魔戒洛汗人之戰吐槽和疑問(雷31
[閒聊] 這件多蒙的真皮外套你會想買嗎?☺15
[閒聊] 拳願Omega 289 這就是邏輯嗎21
[妮姬] 紅舞鞋的聖誕禮物8
[蔚藍] 感冒病毒蔓延6
Re: [閒聊] 修道院的修女們14
[Vtub] 夢野あかり 聖誕歌回35
[閒聊] 老臘入才能懂的醍醐味3
Re: [情報] 新戰隊正式的情報出來了20
[閒聊] 亞克畫動畫訂閱突破10萬3
[GKMS] 莉莉亞13
[24秋] 戰國妖狐 千魔混沌篇 35 傳遞溫暖的結局