为什么码农不写注释了

来源: 托夫勒 2019-09-29 07:06:07 [] [博客] [旧帖] [给我悄悄话] 本文已被阅读: 次 (1681 bytes)

现在写代码已经不流行写注释了。就像小学生读的书需要汉语拼音,到了中学以上就不要了。

为什么注释不重要了?

因为注释所起的功能,都被不同的方式替代了。

比如,以前代码的开头需要介绍下主要功能,现在有Design Document,可以把本来放在注释的东西放到那里面。

现在代码需要写成可分享的模块,你的代码大体包含两个部分,界面与实现。

实现里面不必加注释,因为没人关心。对别人来说,这是黑箱,人家从不打开。

界面不必要加注释,用Optional Parameter,throw Exception等来替代。

代码可以写得Self-Explanatory。

一是变量名、函数名尽量用长一些。

二是长一点的函数都要拆成短的,用合适的名字。

要避免注释,最重要的技术是Refactoring,如果发现函数需要承担以前不能承担任务的时候,要把名字及时Refactoring。

再加上Behavior Driven Development,可以用类似口语的语言来写测试。

不着注释,尽得风流。




更多我的博客文章>>>
请您先登陆,再发跟帖!

发现Adblock插件

如要继续浏览
请支持本站 请务必在本站关闭/移除任何Adblock

关闭Adblock后 请点击

请参考如何关闭Adblock/Adblock plus

安装Adblock plus用户请点击浏览器图标
选择“Disable on www.wenxuecity.com”

安装Adblock用户请点击图标
选择“don't run on pages on this domain”