顯示廣告
隱藏 ✕
※ 本文為 terievv 轉寄自 ptt.cc 更新時間: 2018-12-27 18:45:02
看板 Soft_Job
作者 hidog (.....)
標題 Re: [請益] 寫註解到底是不是好習慣
時間 Thu Dec 27 17:38:16 2018


※ 引述《sec5566 (sec)》之銘言:
: 以前上課跟書本都提到寫註解,
: 但是我看資深同事還有接手的程式碼,
: 都沒有註解,只有我在寫,
: 還被主管念過寫註解沒必要,
: 命名好就夠了,
: 是我觀念落伍了嗎?

有一派看法是code寫的簡潔易讀,靠命名就能知道作用,
寫太多註解沒好處. (因為註解也是需要維護的)

有一種例外
當code充斥大量work around的時候,一定要加註解,避免後面維護的人踩地雷
有些work around你不寫註解,真的沒人看得懂.

建議是先看你的工作環境
如果你的專案維護都有給足夠的時間開發,會定期重構,閱讀性不差,
也有寫unit test等等,這種情況下我同意沒必要寫註解.

反之,就快逃吧.....



--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 118.160.97.186
※ 文章代碼(AID): #1S99sAO1 (Soft_Job)
※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1545903498.A.601.html
KanzakiHAria: 我從來不信命名就能知道作用  程式包含流程邏輯1F 12/27 18:05
KanzakiHAria: 不寫誰知道用三小邏輯去架構的
hidog: 見仁見智囉  我是偏向不管怎樣 寫個簡單的註解幫助後人維護3F 12/27 18:13
windlll: 自己不管怎樣都會寫一下,怕接手的人拿刀來砍我XDDDDD4F 12/27 18:15
fukinhot: 不寫註解 寫文件5F 12/27 18:21
fukinhot: 或是commit message寫完整一點

--
※ 看板: terievv 文章推薦值: 0 目前人氣: 0 累積人氣: 130 
r)回覆 e)編輯 d)刪除 M)收藏 ^x)轉錄 同主題: =)首篇 [)上篇 ])下篇