我对程序员写注释的一点看法

        程序员写不写注释,不能一概而论。

        你代码可读性好,非常标准,别人看起来很舒服,很容易理解读懂,那当然可以不用写注释,更不用每行都写注释,代码本身就是注释,或者代码就是文档。此时,写注释显得有些多余,高手点到为止,无需啰嗦。但是达到这种境界的毕竟非常少,你需要好好评估下你是否真的不需要写注释了。

        但是话说回来,无论您的代码多么优秀,在非常重要且逻辑复杂的地方,还是要注释的,好记性不如烂笔头,这个注释以后对自己对别人都是有很大的帮助的。还有,这个注释,不能是形式上的注释,而应该是实质上的。比如告诉别人那是一个循环,这就是形式上的注释,属于废话了,没有半点作用,但凡是个程序员一看就知道。此时,正确的注释应该是,这段循环起到什么作用,为什么要这么做,没有更好的方案了吗?

        大部分程序员不爱写注释,不要告诉我什么时间仓促,这都是借口,本质上还是懒,既然你希望别人给你写注释,为什么你不能给别人写注释呢?多看看优秀框架的源码,大家会发现老外的代码有个很明显的特点,注释比代码本身要多的多,难道人家时间很充裕?再者,你是在为公司写代码,为团队写代码,为客户写代码的话,而不是你自己一个人代码,你更应该有责任把代码写好注释,甭管您的代码水平如何,如果您写的代码可读性没那么好,没达到那种境界的话。写好注释就是一个负责任的态度,是您的职责所在。而不是逍遥任性随心所欲的写代码。

综上所述,

1,写注释是一种职责,是一种责任,是一种态度。与能力,时间无关。

2,代码写的好,可读性强,可以适当的少些注释;

3,代码写的不好,可读性差,那就更没任何理由不写注释了。

4,写注释关键是要精简,达意,避免形式主义。

你可能感兴趣的:(开发技巧经验分享,软件设计研讨,IT行业,代码注释,代码风格,代码可读性)