跳至主内容

@babel/eslint-plugin

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

@babel/eslint-parser 的配套规则。@babel/eslint-parser 在适配 eslint 以配合 Babel 使用方面做得很好，但它无法修改内置规则来支持实验性特性。@babel/eslint-plugin 重新实现了有问题的规则，从而避免误报或漏报的情况。

需要 Node.js 10.13 或更高版本

安装​

npm install @babel/eslint-plugin --save-dev

在你的 ESLint 配置中加载此插件，并启用所有你想使用的规则（记得同时禁用原始规则！）。

import babelParser from "@babel/eslint-parser";
import babelPlugin from "@babel/eslint-plugin";
import { defineConfig } from "eslint/config";

export default defineConfig([
  {
    files: ["**/*.js", "**/*.cjs", "**/*.mjs"],
    languageOptions: {
      parser: babelParser,
    },
    plugins: {
      babel: babelPlugin
    },
    rules: {
      "new-cap": "off",
      "no-undef": "off",
      "no-unused-expressions": "off",
      "object-curly-spacing": "off",

      "babel/new-cap": "error",
      "babel/no-undef": "error",
      "babel/no-unused-expressions": "error",
      "babel/object-curly-spacing": "error"
    }
  },
]);

规则​

每条规则都对应一个核心 eslint 规则，并具有相同的配置选项。

🛠：表示该规则可通过 --fix 自动修复

提示

在 ESLint 8 或更高版本中，你可以切换回内置规则 no-invalid-this 和 semi。

  • @babel/new-cap: 处理装饰器语法 (@Decorator)

  • @babel/no-undef: 处理类访问器属性 (class A { accessor x = 2 })

  • @babel/no-unused-expressions: 处理 do 表达式

  • @babel/object-curly-spacing: 处理默认导出声明 export x from "mod"; (🛠)

  • @babel/no-invalid-this: 处理类字段和私有类方法 (class A { a = this.b; })

  • @babel/semi: 处理类属性 (🛠)

TypeScript​

虽然 @babel/eslint-parser 可以解析 TypeScript，但我们目前不支持使用 @babel/eslint-plugin 中的规则对 TypeScript 进行代码检查。这是因为 TypeScript 社区已围绕 @typescript-eslint 形成生态，我们希望避免重复工作。此外，由于 @typescript-eslint 底层使用 TypeScript，其规则可实现类型感知，这是 Babel 无法做到的。