eslint-plugin-pony-comments v1.3.2

eslint-plugin-pony-comments

在实际前端项目开发中，开发同学编写代码时写注释的风格不尽一致，并且有些关键代码没有注释，这些都影响着代码的可读性、项目可维护性。虽然团队尽可能地在制定一些公约来要求开发同学去遵守或者引入gerrit代码检视工具，但结果反馈仅依靠人为的方式去避免起到的效果甚微，该插件由此诞生，帮助校验interface、enum、function、type、hooks等关键代码块是否有注释说明。

安装

首先，你需要安装 ESLint:

$ npm i eslint --save-dev

接着，安装 eslint-plugin-pony-comments:

$ npm install eslint-plugin-pony-comments --save-dev

使用

添加pony-comments 到.eslintrc，你可以省略eslint-plugin-前缀：

{
    "plugins": [
        "pony-comments"
    ]
}

然后在规则部分配置您要使用的规则：

{
    "rules": {
        "pony-comments/no-enum-comments": [2, "always", { "leadingCommentType": "Block", "propertyComments": { "pos": "tail", "commentsType": "Line" } }]
    }
}

该插件有导出默认规则，如果你没有自定义规则的需求，可以在extends字段中添加默认规则：

{
    "extends": ["plugin:pony-comments/recommended"]
}

另外，该插件是基于@typescript-eslint/parser解析器做的，如果eslint服务控制台有报解析有关的错误，请指定该解析器

{
    "parser": "@typescript-eslint/parser"
}

如果在yarn start启动项目时报了很多未更改文件的校验错误，需要在根目录下config-overrides.js的override函数中添加config.module.rules.splice(1, 1);

支持的规则

• ✔️如果规则属于recommended配置
• 🛠如果规则报告的某些问题可以通过--fix 命令行选项自动修复
• 💡如果规则报告的某些问题可以通过编辑器建议手动修复