西安VR培训:什么时候应该避免写代码注释
看到标题,我知道你可能会想:“我为什么要避免代码注释,这难道不是一件好事吗?”。是的,写注释在大多数情况下是有用的。但是,请注意,我说的是“在大多数情况下”,因为有一些情况下,你不应该写注释。还不相信?那让蓝鸥西安VR培训机构小编告诉你:写注释有时会坏事!会导致坏代码!
请允许我用一句名言来开始我的论证:
不要注释坏代码——重写吧。
这句话给我流下了非常深刻的印象。仔细想一想,有多少次你注释你的代码,只是因为担心自己将来再回过头来阅读的时候可能会不理解它的意思?至少都做过一次吧。坦率地说,我有很多次是因为这个原因才注释的,尤其是在那些我还是重构和编写干净代码的新手的日子里。
那么,为什么这样的注释反而不好呢?简而言之是因为,我们会因为有注释而放任编写坏的代码!正如你所看到的,注释有时候反而激励了我们去写一些不整洁的代码。
另一个原因是因为注释会误导我们。有多少次你已经改变了代码,却忘了改旁边的注释
?别否认,这种事时常发生。这就是为什么你经常听到这样一句话,“真理只存在于代码中”。
那么,什么时候你不应该写注释呢?
有一个经验法则就是,无论何时你发现自己要使用注释来解释这段代码是用来干什么的
时候,那么基本上就是你的代码需要重构以变得更整洁的时候。
典型的解决方案
现在你知道为什么有时候反而要避免写注释了,那么有什么解决办法吗。事实上,目前
还没有一个有效的解决方案,但是你可以清洁你的代码,这样你(以及其他人)就可以在没
有注释的情况下也能理解它了。
为了用可读的代码替换掉注释,通常我们的典型解决方法是使用提取方法重构
(Extract Method refactoring)。这种重构方式是我喜欢的。
我想说的是,你不应该为你的坏代码注释。请记住,“真理只存在于代码中”。
关注微信公众号“蓝鸥西安”了解更多专业技术资讯。蓝鸥线上学习平台鸥课学院,是蓝鸥旗下的在线教育平台。鸥课学院专注整合优势教学资源、打造适合在线学习并能保证教学结果的优质教学产品,为用户提供满足自身成长和发展要求的有效服务。
请允许我用一句名言来开始我的论证:
不要注释坏代码——重写吧。
这句话给我流下了非常深刻的印象。仔细想一想,有多少次你注释你的代码,只是因为担心自己将来再回过头来阅读的时候可能会不理解它的意思?至少都做过一次吧。坦率地说,我有很多次是因为这个原因才注释的,尤其是在那些我还是重构和编写干净代码的新手的日子里。
那么,为什么这样的注释反而不好呢?简而言之是因为,我们会因为有注释而放任编写坏的代码!正如你所看到的,注释有时候反而激励了我们去写一些不整洁的代码。
另一个原因是因为注释会误导我们。有多少次你已经改变了代码,却忘了改旁边的注释
?别否认,这种事时常发生。这就是为什么你经常听到这样一句话,“真理只存在于代码中”。
那么,什么时候你不应该写注释呢?
有一个经验法则就是,无论何时你发现自己要使用注释来解释这段代码是用来干什么的
时候,那么基本上就是你的代码需要重构以变得更整洁的时候。
典型的解决方案
现在你知道为什么有时候反而要避免写注释了,那么有什么解决办法吗。事实上,目前
还没有一个有效的解决方案,但是你可以清洁你的代码,这样你(以及其他人)就可以在没
有注释的情况下也能理解它了。
为了用可读的代码替换掉注释,通常我们的典型解决方法是使用提取方法重构
(Extract Method refactoring)。这种重构方式是我喜欢的。
我想说的是,你不应该为你的坏代码注释。请记住,“真理只存在于代码中”。
关注微信公众号“蓝鸥西安”了解更多专业技术资讯。蓝鸥线上学习平台鸥课学院,是蓝鸥旗下的在线教育平台。鸥课学院专注整合优势教学资源、打造适合在线学习并能保证教学结果的优质教学产品,为用户提供满足自身成长和发展要求的有效服务。