[問卦] 離職時,把程式註解全刪除?

爆 

餓死抬頭 本魯不是資工系的啦 所以不知道寫程式不加註解會有多嚴重 想請問相關從業的鄉民

60 

大家好 我月薪28k軟體工程師啦 我的觀察齁 程式設計師有好幾種類型 1. 無口型 做了很奇怪的事也不註解，commit也找不到原因 等到哪個有重構強迫症的改壞程式以後才發現原來看似很奇

29 

上週在重構某段程式碼時，其中一位同事在 code review 中建議把某個註解刪掉，另一 個同事看到這個評論時，在下面留了言說他認為不應該刪掉，於是我們就拉了一個小討論 ，聊在程式碼中寫註解這件事。 因為這個經驗，我回去重翻史丹佛電腦科學教授 John Ousterhout 寫的《A Philosophy of Software Design》一書，並整理了筆記。該教授的觀點是認為程式碼寫註解有很多好

11 

說真的，註解也是程式碼的一部分阿 問國小的孩子可能都可以講出正確的答案 部長這樣的發言，幕僚有沒有捏一把冷汗? 然後念資工的高立委，會放過她嗎? 有沒有部長不知道【寫好程式的第一步就是寫好註解】的八卦呢?

11 

最好的作法是 盡量把程式寫得清楚簡單易懂好理解 這樣就不需要加註解了 註解是拿來用在解釋特殊情況 也就是

 5 

隨便一個專案裡的api註解都英文啊， 英文看不懂你連api都不會用。而且這些英文 文法都很固定，連這都看不懂我看程式也學 不好。

 6 

阿幹 全部都包的緊緊的 用extern宣告 查到symbol table，結果東西都在*.a裡面 也沒有註解&參考手冊 就只有名稱能看到

 5 

現在 vs code 已經可以整合 GPT-3 的 API 了。 直接選擇一段程式碼，讓 AI 自動生成註解； 或是反過來，先寫註解讓 AI 產生程式。 也可以直接跟AI聊天。 不分文理組，大家都可以洗洗睡了。

 3 

"寫註解" 這個其實我覺得 Copilot 比 Intellisense 強最多的地方 就好像 Autocompletion的機能延伸到了寫註解上面 打程式的時候用到的頻率滿高的 現在不少LLM可以讀你的repo之後， 會回應你一些問題。不過大部分回應都滿罐頭的就是了