程序员：离职时，研发总监让我把所有代码写上注释！

我从上家公司离职的时候，研发总监让我把之前所有项目的代码都写上注释，但是我其实在写代码的时候是会写注释的，可并不是所有地方都会写，而是在我觉得可能逻辑比较复杂的地方才会写注释。研发总监让我尽量把代码中注释写清楚了，我虽然有点抗拒，但是想想我离职以后公司的状况，本着负责任的态度，也就答应了！

离职时被要求补齐代码注释

因为我在公司里面属于特殊的存在，我所掌握的技术栈虽然很普通，但是整个公司就我一个人会写，其他人虽然会写一点，但是也仅限于会。所以，我想的是，研发总监让我把以前写的代码全部写上注释，可能是为了防止以后我写的代码出现问题，在没有专门的人维护的情况下，遇到简单的问题，他能够根据我写的注释来修改我的代码。

我花了大概一个多星期，将我以前写的项目中的代码逐行分析，并且能写注释的地方我都写上了注释，我当时的想法还是很单纯的，觉得既然决定走了就好聚好散，尽快满足研发总监的要求也能尽快离职重新找工作。

但是，现在想想，我可能还是太单纯了，我当时的研发总监真是良苦用心啊！

离职原因

这得从我提离职的原因说起，简单得说，就是公司研发的一个项目进度非常慢，估算一下，可能无法在指定的时间内完成，不光这样，按照当时项目的开发速度，可能要超出原本估计的项目完成时间的一倍以上，然后老板就开始找研发总监的麻烦了。

而项目开发速度之所以慢，是因为研发总监总是朝令夕改导致的，我当时是研发组长，只有项目任务的分配权，没有项目的整体控制权，也就是项目最终做成什么样子，什么时候做什么模块，是研发总监决定的。

所谓朝令夕改，指得就是上周已经决定并且做好的功能，可能这周研发总监就改变主意了，最终这些功能被打回去重做，但是，这周的进度又不能耽误，最终导致了这周项目的进度和上周遗留的问题重叠。这种情况只发生一次还好，但是每周都在发生，于是项目时间就被挤兑了，本来可以加班完成的，后来加了班时间都不够。

而因为我是项目组长，中间还有很多其他的事情，导致我自己的工作也耽误不少。

所以，当老板想要找研发总监麻烦的时候，研发总监在会议上把责任推给了我，我就找他理论，并且跟他大吵了一架，最终我一气之下就提了离职，下了会以后就给研发总监发了一封离职通知书。

我了解研发总监，他把责任推给我，本意是让我接着，因为老板虽然过问了这个事情，但是下属的责任应该是由上司承担的，但是，公司不会觉得是上司带项目的能力有问题，所以相比承担直接责任，研发总监承担间接责任影响要小得多。

但是，他把责任推给我的时候并没有跟我事先打招呼，以为我会接他的招，但是很显然，我不光没接招，对他还不太客气。

后来，研发总监就让公司人事跟我聊，通过人事跟我聊天的语气，相当于间接通过人事的嘴带研发总监跟我道歉了。但是，我觉得既然事情闹到这个地步，再待下去也日后尴尬，所以就没有收回我的离职通知书。

我当时任职的这家公司只要是离职，基本上把手上的事情交接完成就可以走了，于是我花了一个星期左右就把我应该交接的事情给交接完了，然后我就问研发总监我什么时候可以走，结果研发总监过了一会儿跟我说，让我把以前写的代码都写上注释，尽量写得详细点。

要知道，我在这个公司写的项目代码量是极大的，但研发总监让我写注释，我也没多想，因为公司当时的困境可能是我走之后这些代码在短时间内可能找不到人去维护了。所以，我就花了一个星期把所有项目里我写的代码都写上了注释，写得还挺仔细。

当我写完以后，研发总监还特地把我叫到会议室，一个一个项目得去过这些注释，当时不明白怎么回事，只觉得研发总监有些奇怪，但是又说不上来。

研发总监刻意拖我时间？

最近我在写一篇关于程序员不写注释的文章时，突然就想起来我的上述经历。现在想起来，可能研发总监当时故意在拖我。因为我当时虽然已经提了离职，但是整个公司都不认为我一定会走，并且虽然我已经提了离职，但是研发总监并没有撤我小组组长的职位，该安排的工作也照常安排，人事也隔三差五劝我别走，直到我没事就提醒人事，人事才开了离职证明给我。

最后，研发总监在我走的时候，才意味深长得说了一句：“再见！”。

但是，尽管我注释写得已经很详细了，在我离职后的一段时间内，公司代码出了问题，还是会找我。我那时候还挺不情愿的，觉得这样的话，研发总监让我补注释，图什么？

结论

从这件事情中，我们可以得出一个结论，如果研发总监不是刻意拖我，那么只有两种可能。要么是我代码中注释写得太差，别人看不懂，要么就是即使别人看得懂注释，但是代码看不懂，这和一个程序员的代码水平是有关系的。

有些时候，注释是可以误导人的，这取决于程序员在写注释时的表叔能力，有些时候，当一段代码的注释写得非常清楚，但是看这段代码的程序员搞不清楚代码跟注释的对应关系，那么注释就跟没写一样。

而我，当然不会承认我自己注释写得太差啦！