代码注释的技巧

操作方法

  • 01

    1. 不要侮辱阅读者的智慧要避免没用的注释,例如 if (a == 5)        //如果a等于5    counter = 0    //把counte设为0 这不单把时间浪费在写没用的注释上面,同时也在分散读者的注意力。 2.在内部使用特殊的标签当你在一个团队里工作的时候,采用一组一致的标签能帮助不同的程序员沟通。例如,很多团队会采用“TODO”标签来表示一段尚未完成的代码 int Estimate(int x, int y){    // TODO: implement the calculations    return 0;} 标签注释并不会解释代码,它们寻求注意或者是传递信息。但是如果适当地使用这种技术,要记住跟进这段代码并且完成该标签传递的任务。 3. 直截了当不要在注释里面写过多的废话。避免在注释里面卖弄ASCII艺术,写笑话,作诗和过于冗长。简而言之就是保持注释的简单和直接。 4. 使用统一的风格有些人觉得注释应该让非程序员也能看懂。另外一些人觉得注释需要面对的读者只是程序员。无论如何,正如Successful Strategies for Commenting Code中所说的,最重要的是注释的风格需要统一,并且总是面向相同的读者。就自己而论,我怀疑非程序员是否会去读代码,所以我觉得注释应该面向程序员来写。 5.  要有礼貌应当避免没有礼貌的注释,例如“要注意一些愚蠢的用户会输入一个负数”,或者“修正由菜鸟工程师写的愚蠢得可怜的代码而导致的副作用”。这样的注释对于代码的写注释的人来说并没有任何好处,同时你永远都不会知道将来这些注释会被谁来阅读,你的老板,一个客户或者是刚才被你数落的愚蠢得可怜的工程师。

(0)

相关推荐

  • Android Studio怎么自定义代码注释的颜色?

    工欲善其事必先利其器,在使用Android Studio开发安卓程序时,首先要将Android Studio的各种环境配置好,配置成我们喜欢的风格,这样我们在开发过程中就会很顺手了.代码注释在我们编写 ...

  • eclipse中java和jsp代码注释快捷键

    有时候我们在使用eclipse的时候,想快速注释java代码和jsp代码,快捷键是是什么呢,下面来分享一下方法 方法一:java代码注释快捷键 01 第一步打开eclipse,选中要注释的java代码 ...

  • Eclipse/MyEclipse怎么设置个性化代码注释模板

    在我们进行应用程序开发时,代码注释非常重要,而且往往对代码注释的格式有着严格的要求,为了保证规范而且提高效率,本文以Java开发为例介绍怎么利用Eclipse/MyEclipse IDE定义代码模板 ...

  • 如何设置Eclipse/MyEclipse代码注释样式

    在使用Eclipase/MyEclipse进行代码开发时绝对少不了代码注释,而一旦逻辑复杂时,默认的代码注释便不够醒目,也不利于注释的阅读,本文简单介绍怎么设置代码注释样式 操作方法 01 打开Ecl ...

  • word文档文字加注释的技巧

    用Word制作一些内容时,需要对一些名词什么的添加注释,引到文后或页底用小字来进行详细的说明,这可是论文或者写小说时常用到的技巧 打开需要编辑的文档,将光标移到需要插入脚注和尾注的文字后; 之后在菜单 ...

  • Notepad++代码注释怎么添加和取消?

    Notepad++中想要对代码进行添加注释代或者取消注释,该怎么实现呢?下面我们就来看看使用菜单方式对添加和取消注释方法,详细请看下文介绍. 1.进行打开一个代码的文件,进行选中需要注释的代码. 2. ...

  • Win7系统自定义修改系统文件注释的技巧

    Win7系统自定义修改系统文件注释的技巧

  • 提高代码可读性的十大注释技巧分享

    操作方法 01 很多程序员在写代码的时候往往都不注意代码的可读性,让别人在阅读代码时花费更多的时间.其实,只要程序员在写代码的时候,注意为代码加注释,并以合理的格式为代码加注释,这样就方便别人查看代码 ...

  • Eclipse实用技巧:如何快速注释程序代码

    做程序开发的朋友,相信很多人都在使用Eclipse.Eclipse通过安装插件后,可以支持很多的开发语言,比如Php, Java, .NET, Javascript等等.所以有很多开发人员在使用这个编 ...