zoukankan      html  css  js  c++  java
  • 注释规范和code review

    1.idea统一注释格式

    类注释、方法注释必须包含署名、时间、入参、出参说明等。方法体内代码行注释及字段注释需按照JavaDoc标准编写,必要的步骤需进行注释说明。未实现或有疑问的,使用 // TODO 进行注释说明。

    模板设置:

    方法注释:
    **
    * 方法名: $NAME$
    * 方法描述: TODO <br>
    * $PARAMS$
    * @return {@link $RETURN$}
    * @date 创建时间: $DATE$ $TIME$ <br>
    * @author {个人名字}
    */

    类注释:
    /**
    * 类名称:$NAME$<br>
    * 类描述:TODO <br>
    * @date 创建时间:$DATE$ $TIME$<br>
    *
    * @author {个人名字}
    * @version 1.0.0
    */

    示例:

    字段注释:

    代码注释:

    2.静态代码检查

    静态代码检查:开发者本地需安装SonarLint,阿里规约p3c,同时idea工具的代码规范扫描,开启严格模式,严格要求代码长度篇幅,代码框架,代码规范,命名规范等各方面检查。

    服务端代码检查,采用SonarQube和GitLab双重Review,idea的SonarLint可配置连接我们的SonarQube服务进行检查规则同步。SonarQube地址: (可使用GItLab账号一键登录,登录后,找组长分配权限)

    GitLab的代码Review,采用分支合并请求的方式,由组长进行代码Review。

    同时,项目代码将不定时抽查,组会Review代码,将在代码中进行// FIX 建议,修改后方可提测、上线。

  • 相关阅读:
    python基础学习笔记(二)
    python基础学习笔记(三)
    python基础学习笔记(四)
    python基础学习笔记(五)
    python基础学习笔记(六)
    python基础学习笔记(七)
    python基础学习笔记(八)
    Spring Boot(五):Spring Boot Jpa 的使用
    MySQL优化?
    ⾏级锁定的优点和缺点:
  • 原文地址:https://www.cnblogs.com/andy0816/p/15733443.html
Copyright © 2011-2022 走看看