searchusermenu
  • 发布文章
  • 消息中心
点赞
收藏
评论
分享
原创

代码注释规范介绍

2023-11-02 06:28:15
12
0

良好的代码注释规范可以提高代码的可读性、可维护性和可重用性,同时也可以帮助开发人员之间更好地协作和沟通。

常见的代码注释规范:

  1. 注释的作用:注释主要用于解释代码的意义和作用,包括功能、输入输出、异常处理等信息。注释应该清晰明了,避免使用模糊不清的词汇。
  2. 注释的格式:注释应该采用特定的格式,以便于阅读和理解。常见的注释格式有单行注释、多行注释和文档注释等。单行注释以“//”开头,多行注释以“/”开头和“/”结尾,文档注释以“/**”开头和“*/”结尾。
  3. 注释的用法:注释应该用在对代码的解释上,而不是代替代码。过多的注释会使得代码难以阅读和理解,因此应该尽量减少不必要的注释。
  4. 注释的内容:注释应该包括必要的信息,例如函数的作用、输入参数的意义、返回值的含义等。对于复杂的代码,也应该添加相应的注释来解释其逻辑和实现方式。
  5. 注释的更新:注释应该随着代码的更新而更新,以保证注释的准确性和时效性。当代码发生变化时,也应该及时更新相应的注释。
  6. 注释的规范英文书写:在编写英文代码时,应该遵循规范的英文书写习惯,例如使用正确的单词和语法,避免使用缩写和不规范的表达方式等。

良好的代码注释规范可以提高代码的可读性和可维护性,同时也可以帮助开发人员之间更好地协作和沟通。在编写代码时,应该遵循相应的规范来保证代码的质量和可读性

 

代码提交的说明,用于说明 commit 的类别,只允许使用下面7个标识。

  • feat:新功能(feature)

  • fix:修补bug

  • docs:文档(documentation)

  • style: 格式(不影响代码运行的变动)

  • refactor:重构(即不是新增功能,也不是修改bug的代码变动)

  • test:增加测试

  • chore:构建过程或辅助工具的变动

0条评论
作者已关闭评论
陈****旺
6文章数
0粉丝数
陈****旺
6 文章 | 0 粉丝
原创

代码注释规范介绍

2023-11-02 06:28:15
12
0

良好的代码注释规范可以提高代码的可读性、可维护性和可重用性,同时也可以帮助开发人员之间更好地协作和沟通。

常见的代码注释规范:

  1. 注释的作用:注释主要用于解释代码的意义和作用,包括功能、输入输出、异常处理等信息。注释应该清晰明了,避免使用模糊不清的词汇。
  2. 注释的格式:注释应该采用特定的格式,以便于阅读和理解。常见的注释格式有单行注释、多行注释和文档注释等。单行注释以“//”开头,多行注释以“/”开头和“/”结尾,文档注释以“/**”开头和“*/”结尾。
  3. 注释的用法:注释应该用在对代码的解释上,而不是代替代码。过多的注释会使得代码难以阅读和理解,因此应该尽量减少不必要的注释。
  4. 注释的内容:注释应该包括必要的信息,例如函数的作用、输入参数的意义、返回值的含义等。对于复杂的代码,也应该添加相应的注释来解释其逻辑和实现方式。
  5. 注释的更新:注释应该随着代码的更新而更新,以保证注释的准确性和时效性。当代码发生变化时,也应该及时更新相应的注释。
  6. 注释的规范英文书写:在编写英文代码时,应该遵循规范的英文书写习惯,例如使用正确的单词和语法,避免使用缩写和不规范的表达方式等。

良好的代码注释规范可以提高代码的可读性和可维护性,同时也可以帮助开发人员之间更好地协作和沟通。在编写代码时,应该遵循相应的规范来保证代码的质量和可读性

 

代码提交的说明,用于说明 commit 的类别,只允许使用下面7个标识。

  • feat:新功能(feature)

  • fix:修补bug

  • docs:文档(documentation)

  • style: 格式(不影响代码运行的变动)

  • refactor:重构(即不是新增功能,也不是修改bug的代码变动)

  • test:增加测试

  • chore:构建过程或辅助工具的变动

文章来自个人专栏
2071技术专栏
6 文章 | 1 订阅
0条评论
作者已关闭评论
作者已关闭评论
0
0