如何看待程序员不写注释?
如何看待程序员不写注释?
-
由于大多数程序员是团队开发的,因此我想从团队的角度解释一下不写注释的危害。
不写注释,让我第一个想到的居然是囚徒困境。

囚徒困境博弈论里的一个经典悖论,现在我改编一下。码农小A和小B合作一个项目。如果他们都写注释,每个人都需要开发6天。如果都不写注释,每个人要开发9天。如果一个写注释一个不写,不写注释的需要开发5天,写注释的需要开发10天。
如果你是小A,会怎么做呢?
从直觉出发,肯定是都写注释效率最高,因为两个人都可以在第6天完成任务。但是,换个角度思考,反而是不写注释好一点,为什么?
因为不管对方写不写注释,自己不写注释一定是耗时最短的!
看似矛盾的结论,实际上可能引发一个恶劣的现象,就是大家为了自己的绩效,选择不写注释,这么一来,从老板的角度会发现整体效率降低了,因为都在给对方埋坑。
如果团队里只有一个人不写注释,会怎样呢。他的效率会最高,因为只有他给别人埋坑,没有别人给他埋坑。
因此,从老板的角度,一定要强调代码规范。通过code review和代码扫描等机制,尽可能的把坑排掉,必要的时候甚至可以用一些管理手段,比如奖惩机制等。

当然,实际项目可能远比我举的例子复杂,可能有些模块或系统就是一个人开发一个人维护。这种情况依然建议把注释文档啥的写完善。一来,说不定某一天项目就会转给别人维护。二来,不写注释,自己都会忘记自己的代码。
大家平时开发的时候写注释吗,遇到不写注释的同事又要合作项目的时候怎么沟通的呢?
2018-02-20 19:34:09 -
在开发中很多程序猿不喜欢写注释,或者写的很少。我刚开始也是不怎么写注释,但是后来发现过几天后我都不晓得这段代码的意思了,有时还得跟一下代码。现在基本上公司都会规定开发人员写注释还会定期检查,写注释是一个程序猿的基本操作,看没有注释的代码就像看外国电影没有中文字幕一样猜不到啊。对于不写注释的人来说我只有一句mmp不知该讲不该讲。
2018-02-20 12:37:37