PTT動漫區 / C_Chat (希洽)

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

看板C_Chat (希洽)作者 (strlen)時間22小時前 (2024/12/25 20:51), 19小時前編輯推噓11(11推 0噓 12→)
留言23則, 13人參與, 8小時前最新討論串3/5 (看更多)
※ 引述《ianlin1216 (伊恩可可)》之銘言： : 實務上遇到這種情況真的很賭爛嗎 : 乾五西恰 最好的作法是 盡量把程式寫得清楚簡單易懂好理解 這樣就不需要加註解了 註解是拿來用在解釋特殊情況 也就是 當某段程式你怎麼樣也沒辦法直接用程式碼解釋 這時候你再去下註解 所以理想狀況是 註解應該要非常少甚至完全沒有（小一點的系統 理由很簡單 註解也是要維護 很多人修bug都忙死了 哪來美國時間跟你改註解？ 不然就忘東忘西 這邊修一下那邊調一下 協作時可能還不只一個人在改同個地方 時間一久註解就忘了更新 過時的註解比沒有註解還要來得糟糕 因為反而會誤導別人 然後整個團隊太多人被註解騙惹 越來越不信任註解 最後就乾脆整個無視 但又不曉得該不該刪掉 久了就變成技術債 礙眼的垃圾 但你又不敢動它............... 至於 怎麼把程式寫得清楚簡單易懂 這就是功力問題 呵 -- ※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 118.169.33.144 (臺灣) ※ 文章網址: https://www.ptt.cc/bbs/C_Chat/M.1735131102.A.A4E.html
推
12/25 20:56, 22小時前 , 1F
就很多人自己為自己寫得清楚簡單易懂，殊不知下個接手
12/25 20:56, 1F
→
12/25 20:56, 22小時前 , 2F
專案的，看到只想問候前任的老目
12/25 20:56, 2F
所以要code review 所以要pair programming 所以別悶著頭寫自己的要和人蕉流蕉流 才不會變成自嗨
→
12/25 20:57, 22小時前 , 3F
我看Clean Code也是推薦註解越少越好
12/25 20:57, 3F
※ 編輯: strlen (118.169.33.144 臺灣), 12/25/2024 21:00:32
推
12/25 21:00, 22小時前 , 4F
我有自知之明寫得很爛 乖乖寫註解
12/25 21:00, 4F
推
12/25 21:01, 22小時前 , 5F
就是上備註嘛，不管做什麼工作都需要上備註，有些備註好有
12/25 21:01, 5F
→
12/25 21:01, 22小時前 , 6F
些備註爛
12/25 21:01, 6F
推
12/25 21:02, 22小時前 , 7F
12/25 21:02, 7F
→
12/25 21:02, 22小時前 , 8F
P
12/25 21:02, 8F
→
12/25 21:02, 22小時前 , 9F
只能說做法各有千秋 但很多細部行為只靠著變數名稱去解釋
12/25 21:02, 9F
→
12/25 21:02, 22小時前 , 10F
其實蠻困難的
12/25 21:02, 10F
現在有AI 何不問問萬能的ChatGPT你這東東該怎摸命名 ※ 編輯: strlen (118.169.33.144 臺灣), 12/25/2024 21:05:37
→
12/25 21:09, 22小時前 , 11F
Clean Code寫的和實做差很多阿 人月神話一堆人看過 但業界
12/25 21:09, 11F
→
12/25 21:09, 22小時前 , 12F
還不是用隕石開發法+10個媽媽懷胎1個月
12/25 21:09, 12F
→
12/25 21:10, 22小時前 , 13F
但也是有任天堂這種做的比教科書好還自己開發工具的奇蹟
12/25 21:10, 13F
→
12/25 21:11, 21小時前 , 14F
我現在會用AI測試幫我加註解和重新命名 如果它給的建議很爛
12/25 21:11, 14F
→
12/25 21:11, 21小時前 , 15F
表示你扣寫的很爛他沒辦法判斷 這還滿有用的
12/25 21:11, 15F
推
12/25 21:19, 21小時前 , 16F
我還知道要TDD 要測試即文件 要持續整合 要安全左移呢
12/25 21:19, 16F
推
12/25 21:37, 21小時前 , 17F
公司鎖ChatGpt
12/25 21:37, 17F
公司有提供其它AI工具可用嗎？ 沒有 請趕快逃了啦 跟不上時代的廢物
推
12/25 22:01, 21小時前 , 18F
對ㄚ
12/25 22:01, 18F
※ 編輯: strlen (118.169.33.144 臺灣), 12/25/2024 23:23:10
推
12/25 23:38, 19小時前 , 19F
我也覺得命名比註解還重要 註解只有在命名無法解釋時用
12/25 23:38, 19F
推
12/26 06:04, 13小時前 , 20F
記得有個經典註解是「我他X根本不知道寫這段鬼東西有
12/26 06:04, 20F
→
12/26 06:04, 13小時前 , 21F
什麼意義 但刪了它這該死的玩意兒就不會動」
12/26 06:04, 21F
推
12/26 10:14, 8小時前 , 22F
老闆要求特殊邏輯1，客戶要求特殊邏輯2
12/26 10:14, 22F
推
12/26 10:48, 8小時前 , 23F
真的 封AI的公司還是快逃無誤 只會被歷史的車輪輾死
12/26 10:48, 23F
‣ 更多 strlen 的文章
文章代碼(AID): #1dQ__UfE (C_Chat)
C_Chat 近期熱門文章
更多 近期熱門文章 >>
PTT動漫區 即時熱門文章
更多 即時熱門文章 >>
‣ 更多 strlen 的文章
文章代碼(AID): #1dQ__UfE (C_Chat)