※ 本文為 terievv 轉寄自 ptt.cc 更新時間: 2016-09-23 04:22:06
看板 Gossiping
作者 標題 Re: [問卦] 寫程式不加註解不排版會怎樣?
時間 Thu Sep 22 22:31:45 2016
靠寫程式討飯吃，今年好像是第八年了吧？ (數手指頭)
關於寫註解這件事，心境變化還蠻有趣的...
一開始，沒在寫註解，隔沒多久，連自己也看不懂
=> 領悟到註解的重要，狂寫!! .
過幾天再看的時候，看得懂，但放久了，還是會看不太懂
=> 了解命名的重要性，良好的命名可以大幅降低註解的需求，
與其看註解，不如讓程式碼本身就可讀，註解量又降低了，
與其看註解，不如讓程式碼本身就可讀，註解量又降低了，
但有個大困擾，是不知道要怎麼命名才好，經常為了命名花很多時間
=> 掌握到模組化的手感，可以將一件工作切成適當大小，
類別也好，變數也好，函式也好，API 也好，檔名也好，
剛好可以用一個不長不短又恰當好處的名字來命名，這時註解又更少了
到現在...，又幾乎不寫註解了，
有時會需要看自己幾年前寫的程式碼，尚可讀。
有時會適時的看到自己寫的註解，然後覺得，
如果某個地方的命名改一下，或者是程式結構變一下，這註解就不用寫了。
也不是設計師不愛寫註解，有時候是不知道寫什麼，又或者覺得很花時間...
忘了在哪本書上看到的，書上這麼說:
也不是設計師不愛寫註解，有時候是不知道寫什麼，又或者覺得很花時間...
忘了在哪本書上看到的，書上這麼說:
如果你覺得自己的程式很難寫註解的話，這程式的結構本身可能有點問題了。
一點心得，跟大家分享一下。
--
Would you be my heroine？
https://goo.gl/KbSK7y
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 118.165.195.168
※ 文章代碼(AID): #1Nu-jKhm (Gossiping)
※ 文章網址: https://www.ptt.cc/bbs/Gossiping/M.1474554708.A.AF0.html
※ 同主題文章:
09-22 18:39 ■ [問卦] 寫程式不加註解不排版會怎樣?
09-22 22:14 ■ Re: [問卦] 寫程式不加註解不排版會怎樣?
09-22 22:23 ■ Re: [問卦] 寫程式不加註解不排版會怎樣?
● 09-22 22:31 ■ Re: [問卦] 寫程式不加註解不排版會怎樣?
→ : 薪水多少？1F 09/22 22:33
尚可，至少這些年在台北討生活，還沒為錢的事情苦惱過 ._.→ : 八年，應該300左右吧。2F 09/22 22:33
沒這麼多 XD 大大，貴公司有缺人的話，請給我個面試的機會 XD※ 編輯: archon (118.165.195.168), 09/22/2016 22:35:23
→ : clean code3F 09/22 22:37
推 : 跪求大大傳授心法4F 09/22 22:39
推 : 好像叫做《乾淨的程式碼》之類的5F 09/22 22:48
推 : 天經地義6F 09/22 22:54
推 : 那種一行註解然後讓你看得懂在幹嘛的是最棒的7F 09/22 23:08
推 : 寫到後來免註解 code = 註解 看碼跟看中文一樣8F 09/22 23:09
→ : 看註解反而慢 科科
→ : 看註解反而慢 科科
推 : //10F 09/22 23:23
→ : 越棒的程式需要註解的地方是越少11F 09/23 00:33
--
※ 看板: terievv 文章推薦值: 0 目前人氣: 0 累積人氣: 514
回列表(←)
分享