Ruby编程中代码的注释要怎么注意比较好

来源:爱站网时间:2021-12-16编辑:网友分享
爱站技术频道小编今天来给大家介绍下有关于“Ruby编程中代码的注释要怎么注意比较好”的问题,在团队协作时好的注释能大大增加代码的可读性,希望本篇文章能帮助到各位小伙伴。


    写出自解释文档代码,然后让这部分歇息吧。这不是说着玩。
    使用英文编写注释。
    使用一个空格将注释与符号隔开。
    注释超过一个单词了,应句首大写并使用标点符号。句号后使用 一个空格

    避免多余的注释。

  # bad
  counter += 1 # increments counter by one

    随时更新注释,没有注释比过期的注释更好。

    不要为糟糕的代码写注释。重构它们,使它们能够“自解释”。(Do or do not - there is no try.)

 

    注解应该写在紧接相关代码的上方。
    注解关键字后跟一个冒号和空格,然后是描述问题的记录。

    如果需要多行来描述问题,随后的行需要在 # 后面缩进两个空格。

  def bar
   # FIXME: This has crashed occasionally since v3.2.1. It may
   # be related to the BarBazUtil upgrade.
   baz(:quux)
  end

    如果问题相当明显,那么任何文档就多余了,注解也可以(违规的)在行尾而没有任何备注。这种用法不应当在一般情况下使用,也不应该是一个 rule。

  def bar
   sleep 100 # OPTIMIZE
  end

    使用 TODO 来备注缺失的特性或者在以后添加的功能。

    使用 FIXME 来备注有问题需要修复的代码。

    使用 OPTIMIZE 来备注慢的或者低效的可能引起性能问题的代码。

    使用 HACK 来备注那些使用问题代码的地方可能需要重构。

    使用 REVIEW 来备注那些需要反复查看确认工作正常的代码。例如: REVIEW: 你确定客户端是怎样正确的完成 X 的吗?

    使用其他自定义的关键字如果认为它是合适的,但是确保在你的项目的 README 或者类似的地方注明。

一个好的编程代码,除了有自己独特的思路外,团队的协作力也是非常重要的,想要呈现一个好作品,很多问题都需要注意清除。希望爱站技术频道小编整理的资料能帮助到大家。

上一篇:Ruby编程入门介绍

下一篇:Ruby编程中需要怎么编写字符串

您可能感兴趣的文章

相关阅读

热门软件源码

最新软件源码下载