uniapp规范开发（5）注释规范

注释规范

代码注释在一个项目的后期维护中显的尤为重要，所以我们要为每一个被复用的组件编写组件使用说明，为组件中每一个方法编写方法说明

务必添加注释列表

1. 公共组件使用说明

2. 各组件中重要函数或者类说明

3. 复杂的业务逻辑处理说明

4. 特殊情况的代码处理说明,对于代码中特殊用途的变量、存在临界值、函数中使用的 hack、使用了某种算法或思路等需要进行注释描述

5. 多重 if 判断语句

6. 注释块必须以/**（至少两个星号）开头**/

7. 单行注释使用//

单行注释

注释单独一行，不要在代码后的同一行内加注释。例如：

  // bad
 
  var name =”abc”; // 姓名    
 
  // good
 
  // 姓名
  var name = “abc”;         

多行注释

组件使用说明，和调用说明
      /**
      * 组件名称
      * @desc 组件描述
      * @author 组件作者
      * @date 2017年12月05日17:22:43
      * @param {Object} [title]    - 参数说明
      * @param {String} [columns] - 参数说明
      * @example 调用示例
      *  
      **/

很赞哦！ (0)