ESLint 找不到配置 … 以扩展

症状

当使用旧版 ESLint 配置系统时，您可能会在安装依赖项后运行 ESLint 时看到此错误

ESLint couldn't find the config "${configName}" to extend from. Please check that the name of the config is correct.

The config "${configName}" was referenced from the config file in "${importerName}".
1
2
3

原因

ESLint 配置文件通过其包名称在 extends 数组中指定可共享的配置。该包名称被传递给 Node.js require()，它在本地 node_modules/ 目录中查找该包。例如，以下 ESLint 配置将首先尝试加载位于 node_modules/eslint-config-yours 的模块

module.exports = {
    extends: ["eslint-config-yours"],
};
1
2
3

当您尝试从配置扩展，并且在任何搜索到的 node_modules/ 中都找不到该配置的包时，会输出此错误。

发生这种情况的常见原因包括

• 未运行 npm install 或等效的包管理器命令
• 错误键入包和/或配置的区分大小写的名称

配置名称变体

请注意，ESLint 支持几种配置名称格式

• eslint-config- 配置名称前缀可以为了简洁而省略，例如 extends: ["yours"]
  • @ npm 作用域包将 eslint-config- 前缀放在组织作用域之后，例如 extends: ["@org/yours"] 以从 @org/eslint-config-yours 加载
• plugin: 前缀表示配置是从共享插件加载的，例如 extends: [plugin:yours/recommended] 以从 eslint-plugin-yours 加载

解决方案

此问题的常见解决方案包括

• 将所有包的所有版本升级到最新版本。
• 在您的 package.json 中将配置添加为 devDependency。
• 运行 npm install 或等效的包管理器命令。
• 检查您的配置文件中的名称是否与配置包的名称匹配。

资源

有关更多信息，请参阅

• 旧版 ESLint 配置文件，了解有关旧版 ESLint 配置格式的文档
  • 旧版 ESLint 配置文件 > 使用可共享的配置包，了解有关使用可共享配置的文档
• 共享配置，了解有关如何定义独立共享配置的文档
• 创建插件 > 插件中的配置，了解有关如何在插件中定义共享配置的文档