顯示廣告
隱藏 ✕
※ 本文為 terievv 轉寄自 ptt.cc 更新時間: 2016-09-23 04:22:06
看板 Gossiping
作者 archon (內湖流川楓)
標題 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
james732: 薪水多少?1F 09/22 22:33
尚可,至少這些年在台北討生活,還沒為錢的事情苦惱過 ._.

Kreen: 八年,應該300左右吧。2F 09/22 22:33
沒這麼多 XD   大大,貴公司有缺人的話,請給我個面試的機會 XD
※ 編輯: archon (118.165.195.168), 09/22/2016 22:35:23
YahooTaiwan: clean code3F 09/22 22:37
acolam: 跪求大大傳授心法4F 09/22 22:39
Plot3D: 好像叫做《乾淨的程式碼》之類的5F 09/22 22:48
lonysancho: 天經地義6F 09/22 22:54
keyut2433: 那種一行註解然後讓你看得懂在幹嘛的是最棒的7F 09/22 23:08
JeanSijhih: 寫到後來免註解  code = 註解  看碼跟看中文一樣8F 09/22 23:09
JeanSijhih: 看註解反而慢  科科
cycwtu: //10F 09/22 23:23
redok: 越棒的程式需要註解的地方是越少11F 09/23 00:33

--
※ 看板: terievv 文章推薦值: 0 目前人氣: 0 累積人氣: 669 
作者 archon 的最新發文:
點此顯示更多發文記錄
r)回覆 e)編輯 d)刪除 M)收藏 ^x)轉錄 同主題: =)首篇 [)上篇 ])下篇