如何修复Strapi插件的eslint错误import/no-extraneous-dependencies？

针对你遇到的Strapi插件ESLint依赖识别异常、修改packageDir后VCS中ESLint失效的问题，可通过以下几种方案解决：

方案1：配置ESLint多模块搜索路径 #

在插件目录的.eslintrc.js中添加settings.node.paths，同时指定核心项目和插件自身的node_modules路径，让ESLint同时识别两类依赖：

const path = require('path');

module.exports = {
  // 保留原有ESLint配置
  settings: {
    node: {
      paths: [
        // 指向Strapi核心项目的node_modules
        path.join(__dirname, '../../node_modules'),
        // 插件自身的node_modules
        path.join(__dirname, './node_modules')
      ]
    }
  }
};

此方案无需修改packageDir，既能解决Strapi核心包的识别问题，又不会破坏VCS中ESLint的正常工作逻辑。

方案2：借助eslint-plugin-import配置解析器（若使用该插件） #

如果项目依赖eslint-plugin-import，可通过配置import/resolver指定多路径解析：

const path = require('path');

module.exports = {
  // 保留原有ESLint配置
  settings: {
    'import/resolver': {
      node: {
        paths: [
          path.join(__dirname, '../../node_modules'),
          path.join(__dirname, './node_modules')
        ]
      }
    }
  }
};

该方案适用于需要规范导入路径的场景，同样不会影响VCS的ESLint运行。

方案3：在插件package.json中声明peerDependencies #

在插件的package.json里添加peerDependencies，明确标记Strapi核心包由宿主项目提供：

{
  "peerDependencies": {
    "@strapi/strapi": "^4.0.0",
    "@strapi/admin": "^4.0.0"
    // 按需添加其他用到的Strapi核心包
  }
}

此方法会让ESLint清楚知晓这些包无需在插件本地安装，直接由上层核心项目提供，从而消除依赖未找到的警告。

关键注意事项 #

• 不要使用packageDir配置：该配置会强制ESLint将插件目录作为依赖查找根目录，导致VCS无法正确识别项目全局路径，进而引发ESLint失效。
• 若使用pnpm/yarn workspace等多包管理工具，需确保workspace配置正确，让ESLint能跨包识别依赖。

内容的提问来源于stack exchange，提问作者John Smith