作者:
chia7712 (Spright)
2018-01-28 03:10:56※ 引述《Ommm5566 (56天團)》之銘言：
: ※ 引述《p52189 (鼠霸)》之銘言：
: : 如題……原始碼不長
: : 但撰碼習慣跟我完全不同
: : 到現在我也還沒找到規則
: : 以至於想改一小部分都因為不知道規則而必須幾乎全部爬一遍才改得動
: : 每次讀都很難沉住氣一下就很煩躁不想做了
: : 一直這樣很像也不是辦法
: : 請問大家有什麼方法可以坐得住嗎= =
: : 謝謝……
: :
除非很明顯在做啥 我們幾乎所有的 code都要註解
我遇到的快要被要求接近每一行都要我剛加入時就是在幫別人寫註解 Q_Q
每一行都要註解也太攏長了，要不要看看寫法是否可以調整？
作者:
robler (章魚丸)
2018-01-28 10:09:00註解寫太多只是突顯程式寫的很爛的問題
作者:
NDark (溺於黑暗)
2018-01-28 10:16:00光寫不寫註解就吵成一片了. 還談甚麼風格.---- 以下 tab/space大戰 開始 ----
我也當初這樣反映過 不過要照什麼convention...也是只有那種很明顯的code才不用寫
讀人家代碼需要什麼休養? 就能力不夠讀的很痛苦而已代碼到底有多難讀，就跟文章一樣你是語言不熟嗎?不要自己爛就覺得讀的痛苦很正常好嗎看一下架構就知道他等級到哪了，根本沒難度好嗎不會寫的也不可能分層到哪裡去也不太需要切到幾次class可悲
作者:
feeya (24 August 升格為鄉民)
2018-01-28 11:32:00一個func有3~4頁常都是if包if包好幾層 這種讀的很痛苦
某T幹嘛7pupu,又不是什麼狀況你都遇過,還是你寫的code,別人覺得難讀?
老子看別人code好多年，也幫別人改過 根本沒感覺就讀起來很不方便而已 沒必要講的好像看別人CODE很生氣代表自己很強，我最討厭這種裝b的
作者:
stosto (樹多)
2018-01-28 12:37:00看得不爽罵兩句而已,這種東西讀不懂該檢討自己吧
T大是真的沒看過程式碼寫的很爛的，所謂很爛指的是該縮排不縮；好幾層if；程式碼太多重覆；變數隨便亂取亂創看不懂是真的，因為call來call去，自己也不知道call哪
作者:
Masakiad (Masaki)
2018-01-28 12:58:00高階語言需要註解都是本身寫太爛
作者:
sharku (明珠求瑕)
2018-01-28 13:45:00推樓上
作者:
tyc5116 (累人啊....)
2018-01-28 15:46:00T大試著去讀看看泡泡code吧，看你要花多少時間
我看過用AJAX call來call去的 追得很不爽
作者:
Ommm5566 (56天團)
2018-01-28 18:19:00泡泡code好懷念 IOCCC大賽
作者:
y3k (激流を制するは静水)
2018-01-28 18:31:00高階語言需要註解都不及格+1
你也知道立場不同差很多了，搞不好下一個看到你的code又覺得這個人寫注解也寫的太囉嗦了，又上來PO文lol我也很討厭那種整天嫌人寫code怎樣的，感覺很幼稚
作者:
mathrew (Joey)
2018-01-28 20:24:00每行都寫反而更難讀吧 一團亂
作者:
Ommm5566 (56天團)
2018-01-28 20:32:00現在越來越強調Hierarchy的設計了 畢竟大團隊是小團隊組成 拆成小團隊就還可以最表面給user使用的API介面型狀和抽象層次要同一註解也盡量詳盡 這個層級的註解相當於文件了然後中間各個team自行決定coding style 註解適量最下層每個人會有各自的習慣 這邊就仰賴寫程度和良心不管甚麼時候遇到個人習慣都是無解阿XD
作者:
chia7712 (Spright)
2018-01-28 22:08:00別激動啊。讀code的耐心不一定是指對方code不好，很多時候只是寫code的人的邏輯差異甚大而已，而這也是為啥註解很重要。能不用註解就讓團隊都看懂的程式碼很棒，但事實上專案不大還可以達到，但當你專案長到幾百萬行的時候就有難度了
作者:
NDark (溺於黑暗)
2018-01-28 22:48:00樓上有邏輯漏洞. 一開始都不會認為最後會變成幾百萬行.
我也覺得每行都寫一團亂 但就如樓上幾樓所說的要看是前還是後 有些API真的就是要求一行一行寫好處就是後面的人可以跟上不過最煩的還是不寫英文的...寫什麼法語之類的Q_Q
靠杯我看過寫日文的註解跟德文的XDD變數名稱與其物理意義不相符也很囧
作者:
chuegou (chuegou)
2018-01-28 23:53:00我現在遇到最困擾是magic number沒註解 只能乾瞪眼
作者:
netburst (133 134 592)
2018-01-29 00:15:00縮排沒差吧 IDE FORMAT一秒
事實上就是沒有完美的 coding style 什麼高階語言不用註解在大一點的codebase 是不大可能的人人都覺得自己寫得最漂亮
作者:
chia7712 (Spright)
2018-01-29 02:15:00NDark大說到重點了，一開始沒把專案當成大型專案來管理，等到有一天發現已經變成怪物就來不及了，只能付出更多時間來補救。
我主管都只想解決眼前問題 沒想到日後維護製造出來的技術債只好後人來還了
對於註解的想法,我的觀念是站在clean code這邊,也就是非必要不寫註解
作者:
SABA0 (A柱)
2018-01-29 16:49:00沒看過用註解寫日記的吼。 看得我都要哭了
哈哈哈非必要不寫 所以你的命名都很完美?語意真的都清楚可以讓後人看懂?
常常實作還會有一些假設 複雜度也未知 沒寫注釋就是要讀內容摟
我是看過很多人只會逼別人寫註解,然後自己死不肯寫註解說自己寫的code好所以不寫,然後又愛批評別人的註解
Sidney0503你在悲憤啥?看清楚我表達的是非必要不寫,不是絕對不寫,你覺得取名技巧不好人家看不懂,不就是你說我說的"必要的時候"嗎?
作者:
Ghamu (貓丸)
2018-01-31 01:06:00我都是func名稱無法表達意思 想一陣 真不得已才上註解補充所以對那種胡亂取名 寫一大堆註解的人超不爽想罵幹 代表根本就沒把其他合作開發的工程師放在眼裡嘛clean code也說過了 註解一堆根本不可能期待會被下一個改的人持續更新維護 有一個人漏 下次看到註解與程式本身不一致就會陷入混亂
作者: t64141 (榕樹) 2018-01-31 10:24:00
同意樓上，年久失修的註解常常扮演誤導後人的角色