本文详解如何修复因启用 @babel/eslint-parser 导致 eslint 规则全部失效的问题，重点指出 sourcetype: "module" 与 babel 解析器的兼容性冲突，并提供可直接使用的精简、稳定配置。
本文详解如何修复因启用 @babel/eslint-parser 导致 eslint 规则全部失效的问题，重点指出 sourcetype: "module" 与 babel 解析器的兼容性冲突，并提供可直接使用的精简、稳定配置。
在使用 ESLint 进行现代 JavaScript（尤其是含 import assertions、JSON 模块导入等新语法）校验时，开发者常会引入 @babel/eslint-parser 作为替代默认解析器的方案。但一个常见且隐蔽的陷阱是：一旦显式设置 "sourceType": "module"，Babel 解析器将跳过规则加载流程，导致所有自定义规则静默失效——这正是提问者遇到的核心问题。
根本原因在于：@babel/eslint-parser 内部已根据文件扩展名（如 .js, .mjs）和 ecmaVersion 自动推断模块类型；手动指定 sourceType 会干扰其内部解析上下文初始化逻辑，进而使 ESLint 的规则注册机制无法正确绑定到 AST 节点。
✅ 正确做法是 移除 parserOptions.sourceType 字段，仅保留必要配置：
{
"env": {
"browser": true,
"es2021": true,
"mocha": true
},
"extends": [
"eslint:recommended",
"plugin:import/errors",
"plugin:import/warnings"
],
"parser": "@babel/eslint-parser",
"parserOptions": {
"ecmaVersion": "latest",
"requireConfigFile": false,
"babelOptions": {
"plugins": ["@babel/plugin-syntax-import-assertions"]
}
},
"rules": {
"indent": ["error", 4],
"linebreak-style": ["error", "windows"],
"quotes": ["error", "single"],
"semi": ["error", "always"],
"prefer-template": "error",
"block-spacing": ["error", "always"],
"spaced-comment": ["error", "always", {
"line": { "markers": ["/"], "exceptions": ["-", "+"] },
"block": { "markers": ["!"], "exceptions": ["*", "+", "-"], "balanced": true }
}],
"space-in-parens": ["error", "always", {
"exceptions": ["()", "empty", "{}", "[]"]
}],
"object-curly-spacing": ["error", "always", { "arraysInObjects": false }],
"no-trailing-spaces": ["error", { "ignoreComments": true }],
"no-var": "error",
"prefer-const": "error"
}
}
⚠️ 关键注意事项：
- 不要为 @babel/eslint-parser 添加 @babel/ 前缀规则（如 "@babel/indent"）——它不提供此类规则，应直接使用 ESLint 原生规则（如 "indent"）；
- 确保已安装对应依赖：
npm install --save-dev @babel/eslint-parser @babel/plugin-syntax-import-assertions eslint-plugin-import
- 若项目使用 TypeScript，请改用 @typescript-eslint/parser；Babel 解析器不支持 TS 类型检查，仅用于语法转译层解析；
- requireConfigFile: false 表示无需 babel.config.json，适合简单场景；若需复杂 Babel 配置（如 preset-env），建议设为 true 并提供独立配置。
总结：Babel 解析器与 ESLint 的集成关键在于“少即是多”——避免冗余字段（尤其是 sourceType），信任解析器的自动推导能力，并专注通过 babelOptions.plugins 启用所需语法插件。配置精简后，不仅规则恢复生效，还能显著提升 lint 启动速度与稳定性。
