1. 程式人生 > >管理感悟:程式碼缺的不是註釋,而是自解釋

管理感悟:程式碼缺的不是註釋,而是自解釋

  重複一遍:

  大家以為有用的註釋、文件,其實大多是沒用的。汝自己寫過什麼樣的有用註釋,文件?

 

  以前看到一個說法:程式碼要有自解釋的特性,而不是寫大量註釋。深以為然。

  註釋咱不說了,自解釋什麼意思?吾思考,有以下幾點:

  目錄名、檔名、函式名、變數名,要夠長,能夠達到顧名思義的程度。這個說起來容易,其實大多數人做不到。這個時候吾建議照抄。

  使用標準縮寫。如果自己創造了新的縮寫和名詞,要加以說明,並通用化(即碰到同樣情況,使用同樣的縮寫)。

  儘量使用final這樣的修飾符。

  其他的還有,模組化、弱耦合、強內聚、程式碼對齊等等。

 

  說起來容易,做起來難。大多數程式設計師都會當作耳旁風,所以寫好程式碼的人不多(水平差的也看不出來)。

  自然的,註釋、文件都是浪費時間的,不要盲目強調。