程序员最讨厌的事情难道不是频繁改需求？原来程序员最讨厌这个…

做为一名程序猿最讨厌作的事是什么?

产品经理频繁修改需求?不是。

测试每天给你提交不可理喻的 bug ?也不是。

接手别人交接的如火星文同样的烂代码?还不是。

‍▼

程序员最讨厌的四件事：

写注释、写文档、别人不写注释、别人不写文档。

不错，今天咱们就来谈谈程序员最讨厌作的这件事：

写注释!

程序员该不应写注释?

其实对于写注释这件事来讲，仍是有必定的争议的，争议其实不在于该不应写注释，而是在于不要过多的写注释，注释多了，反而会让你感受整个代码比较混乱不堪，影响视觉。

并且为何不太鼓励你们过多的去写注释呢?由于代码即注释

何为代码即注释?代码是具备自解释功能的，高质量，命名规范的代码，其实程序员应该一眼就可以看懂这段代码的功能做用是什么?

因此，程序员到底该不应写注释?

事实证实：该，可是要注意分寸。

1.优秀的程序员能够少写注释~

优秀的程序员都是懒的。由于懒，他才会写出各类各样的工具来替本身干活。由于懒，他才会想办法避免去写无聊重复的代码——所以避免的代码的冗余，削减了代码的维护成本，使重构变得更加容易。

代码即注释。做为一个优秀的程序员，大多数都懂得注释不是用来翻译程序代码的，用代码能说清楚的东西，就天然不用费脑子去写注释了，集中精力写出最优雅、高质量的代码才是首要的。自己对于简短的代码，规范的命名、条理清晰的书写方式，让人一看就懂，那么自己这个代码就不须要注释，它自身就具备自解释功能。

固然，若是一个函数上百行代码，甚至更多，仍是须要写必定的注释的，甚至在一个重要的业务逻辑处理的地方，仍是须要注明一些注释的，毕竟时间久了，业务逻辑不熟悉了，看代码确实有些费劲。

2.初级中等程序员仍是得写注释~

做为一个入门，初级或者中等的程序员，在本身代码质量不高的阶段，时刻提醒本身养成一个好的写注释的习惯仍是颇有必要的。

为何不少程序员不肯意接手别人写的代码，是由于有一个问题就是必然存在的。每一个人的编码风格不同，命名方式和规范不同，加上因为程序员代码的个性化，就造就了代码的多样性。假若再没有注释，谁还愿意看?因此，前期记住必定得写注释。

记住：与人方便就是与己方便。

为何谈这个话题?

对，为何谈这个话题呢？由于有不少程序员写代码总有一种很是很是很差的习惯，那就是一段代码不用了，注释掉，可是他内心还总想着感受这段代码之后可能还会用。因此就留着，不删掉，但大多数状况下，过几天就忘了，结果代码里处处都是注释，没有一句是有用的。

接下来好了，接手的读代码的人也不敢删，一直留着，留着，留着，留着……直到永远。

大家大声告诉我，大家是否是有这种习惯？是否是有这种心理？

注释维护

我想说，注释也是须要维护的。不少人都没有意识到注释维护的重要性。怎么说呢？不写注释坑人，比不写注释更坑人的就是写了注释，功能变了，不修改注释的人。

好比：

今天是程序员小王写了一个处理业务逻辑的功能方法，功能是炒菜。过了两个月后，需求变了，人家客户不喜欢吃炒菜，须要换成了煮菜了。这时程序员小陈就在炒菜的功能方法上直接修改了，把功能改为了煮菜。可是注释上写的仍是炒菜。又过了两个月，客户需求又变了，客户吃腻了煮的菜，要求改为蒸饭。

这时项目经理说：小郭，你把那个煮菜功能给我换成蒸饭。这时，程序员小郭，找啊找，找遍了注释，发现没有煮菜功能，一气之下，算了，本身写吧，本身又写了一个蒸饭的功能函数。以后带有炒菜注释的煮菜功能，在接下来的一个又一个程序员都不敢删，也无论了。

看到了，注释不维护，是否是很很差。这只是其中一个方法，若是你修改了大部分的方法，又没有修改注释，接下来接手的程序员又不敢乱动，还看不懂，本身又从新写，代码冗余，混乱不堪，以后愈来愈烂，代码愈来愈没人管了，也不想干了。

呕出一口老血!

总结

代码即注释，写注释要注意分寸。以下：

► 用高质量的代码代替注释。

► 在复杂函数和重要的业务逻辑面试，仍是必需要写注释的。

► 注释须要维护，不是写了就好。不维护，还不如不写。

►要学会命名，遵照规范，这样才可以培养出好习惯。

Android学习PDF+架构视频+面试文档+源码笔记

最后

感谢你们能耐着性子，看完这篇文章。

在这里我也分享一份本身收录整理的Android学习PDF+架构视频+面试文档+源码笔记，还有高级架构技术进阶脑图、Android开发面试专题资料，高级进阶架构资料帮助你们学习提高进阶，也节省你们在网上搜索资料的时间来学习，也能够分享给身边好友一块儿学习

若是你有须要的话，能够点赞，关注我，而后加入关注微信公众号【Android开发之家】免费领取