管理感悟:代码缺的不是注释,而是自解释

  重复一遍:

  大家以为有用的注释、文档,其实大多是没用的。汝自己写过什么样的有用注释,文档?

 

  以前看到一个说法:代码要有自解释的特性,而不是写大量注释。深以为然。

  注释咱不说了,自解释什么意思?吾思考,有以下几点:

  目录名、文件名、函数名、变量名,要够长,能够达到顾名思义的程度。这个说起来容易,其实大多数人做不到。这个时候吾建议照抄。

  使用标准缩写。如果自己创造了新的缩写和名词,要加以说明,并通用化(即碰到同样情况,使用同样的缩写)。

  尽量使用final这样的修饰符。

  其他的还有,模块化、弱耦合、强内聚、代码对齐等等。

 

  说起来容易,做起来难。大多数程序员都会当作耳旁风,所以写好代码的人不多(水平差的也看不出来)。

  自然的,注释、文档都是浪费时间的,不要盲目强调。

你可能感兴趣的:(灵感杂谈,软件技巧,管理感悟,行业点评,管理感悟)