代码中的注释有标准格式吗? [关闭]

2024-01-10

我想知道人们在代码中是否有标准的注释格式。不是方法或类的 xml 注释,而是注释within一个方法。


也可以看看:

是否有注释 C# 代码的标准(如 phpdoc 或 python 的 docstring)? https://stackoverflow.com/questions/34516/is-there-a-standard-like-phpdoc-or-pythons-docstring-for-commenting-c-code


除了格式之外,您确实应该考虑一些事情来做出好的评论。

  1. 不要简单地重述代码正在做什么。例如,
 // Start the services
 StartServices();

这是一个可怕的评论!

  1. 描述why。为什么代码会执行它正在执行的操作?业务假设或算法步骤是什么?

  2. 格式化您的评论以实现最大程度的可读性。正确地标记它们,在必要时留出空格等。

  3. 如果有人已经开始以标准方式发表评论,请不要违反该标准。

  4. 查看 MSDN 上这篇有关撰写有效评论的文章:http://msdn.microsoft.com/en-us/library/aa164797.aspx http://msdn.microsoft.com/en-us/library/aa164797.aspx

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

代码中的注释有标准格式吗? [关闭] 的相关文章

  • 从实现类中的接口继承注释?

    假设我有这个界面 public interface IFoo
  • 如何用 PHP 解析 phpDoc 风格的注释块?

    请考虑以下代码 我尝试仅解析文件中的第一个 phpDoc 样式注释 不使用任何其他库 出于测试目的 将文件内容放入 data 变量中 data file A lot of info about this file Could even co
  • 如何将 < > 括起来的项目添加到文档注释中

    我正在尝试编写文档注释 但是我遇到了问题
  • 在 Xcode 中自动生成方法注释

    Xcode 中有没有一种方法可以自动生成方法注释 类似于您在 Eclipse 中对 javadoc 注释所做的操作 例如 您可以在方法声明之前的一行点击 Eclipse 会自动生成方法注释的框架 您可以使用快捷方式创建标题文档 where
  • Todo 任务未出现在 Visual Studio 2012 的任务列表中

    我最近升级到 Visual Studio 2012 除了以 todo 开头的注释不再显示在任务列表中之外 没有任何问题 我完全不知道从哪里开始寻找这个问题的解决方案 因为所有关键字都太笼统了 我遇到了其他类似的问题 答案是包含 todo 注
  • 如何通过 jQuery 使用 Django 模板标签和过滤器?

    一般问题是这样的 我有一个包含内容的页面 用户可以对其进行评论 插入评论应该在不重新加载页面的情况下进行 评论表单在视图中处理 该视图将评论保存到数据库 保存评论后 我将新评论序列化为 json 并返回页面 data serializers
  • 在单行 CSS 中添加 // 作为个人注释样式是一种不好的做法吗?

    我最近开始使用 注释 单行 CSS 代码 我知道我实际上并没有注释掉该行 我只是打破它 我应该使用 但效果是一样的 然后该行终止于 并且以下代码工作正常 我可以删除它 但通常我不喜欢这样做 以防万一我想稍后将其放回去 或者如果我回来查看我一
  • 使用Rhino的Javascript解析器,如何获取评论?

    我有一些 javascript 文件并使用 Rhino 的 javascript 解析器解析它 但我看不到评论 我怎样才能得到评论 这是我的代码的一部分 运行此代码 comment 变量为空 另外 在运行 astRoot toSource
  • Python如何在使用Python写入新值后保持XML注释存在?

    我有一个 XML 文件 然后需要更新一些值 我的 XML 文件包含注释 我想在编写 XML 后保留注释 但它消失了 这是我的 XML
  • 关于龙的可怕代码注释是什么?

    这句话被用来警告代码正在做一些严重的特技 我对此的谷歌搜索是空的 但我记得很久以前有人在谷歌上搜索过这个短语 谎言中的龙 龙睡在这里 Bah 这里是龙 http en wikipedia org wiki Here be dragons 最
  • 如何在 Office VBA 编辑器中注释和取消注释代码块

    In the VBA editor of Office ALT F11 how do you comment or uncomment a block of code 在 VBA 编辑器中 转到View Toolbars Customise
  • 在快速帮助文档注释中添加 Swift 类的链接?

    假设我有两个课程 This class should be used together with Foo class Bar func doNothing Description of what Foo does goes here cla
  • 忽略 doxygen 注释块中的行

    是否可以在 doxygen 注释块中包含将被 doxygen 忽略的内容 换句话说 我们可以在 doxygen 评论块中发表评论吗 背景 我们正在将 Fortran 项目的代码内注释转换为 doxygen 可解析的格式 但是该项目要求代码内
  • 在哪里记录 C 或 C++ 中的函数? [关闭]

    Closed 这个问题是基于意见的 help closed questions 目前不接受答案 我有一个包含多个文件的 C 程序 所以我有 例如 stuff c它实现了一些功能 并且stuff h与函数原型 我应该如何在注释中记录功能 我应
  • 如何在 Rails 视图中注释代码?

    当我使用 Rails 并开发视图时 我经常想注释掉代码 类和模型足够简单 但是views有点棘手 在视图中注释代码的最佳方式是什么 这样它就不会被任何东西解释 HTML 给了我们尽管这里包含的代码似乎无论如何都会被解释 或者还有更 Rail
  • 获取 Disqus html 代码以显示在源代码中以实现 SEO 目的

    最近开始在网站上使用 Disqus 想知道是否有任何方法可以让实际的 html 代码显示在源页面中 我注意到这个网站正在这样做 http adamkaras com blog 2009 06 24 disqus custom css sty
  • 如何防止 yaml-cpp 解析器删除所有注释?

    我有一个项目需要阅读一份详细的文档yaml文件 修改几个值 然后写回 麻烦的是yaml cpp完全删除所有评论并 吃掉 它们 有趣的是 YAML Emitter类允许向输出添加注释 有没有办法保留输入中的注释并将它们写回到我没有看到的库中
  • 如何在 Xcode 中保持标题注释最新

    Xcode 习惯于将各种 冗余 信息放在它创建的每个代码文件的顶部 其中包含版权声明 类名 项目名和客户端名称 不管你喜欢与否 一旦你创建了一个新的类 A 然后将其重构为 B 信息就已经是错误的 评论会一直说这是 A h 或 A m 此外
  • #ifdef MACRO 相当于注释吗

    假设 MACRO 没有定义 这些是等价的 ifdef MACRO Not valid C or C code endif Not valid C or C code 在 GCC 4 7 1 中 它似乎是等效的 但是否有预处理器可以做更多的事
  • Textmate“注释”命令对于 css 代码无法正常工作

    当我在 TextMate 中切换 CSS 源代码的注释时遇到一些问题 Using the shortcut CMD I activate the Comment Line Selection command from the source

随机推荐