从Yarn迁移至pnpm后ESLint无法找到eslint-plugin-n插件求助

可能原因 #

• pnpm默认的依赖隔离机制：pnpm不会像Yarn v1那样将所有依赖平铺到node_modules根目录，仅直接依赖会放在根目录。如果ESLint在查找插件时无法遍历到嵌套的依赖目录，就会出现找不到插件的情况。
• 本地与CI的lockfile版本不兼容：若本地使用更高版本pnpm生成pnpm-lock.yaml，CI用pnpm 6.9.0读取时可能出现依赖安装异常。
• CI缓存残留：旧的node_modules缓存可能干扰新的依赖安装流程。

解决方法 #

• 调整pnpm的hoist配置，确保ESLint插件被提升到根目录：
  在项目根目录的.npmrc文件中添加以下配置：

  hoist-pattern[]=eslint-plugin-*
  

  该配置会让所有eslint-plugin-开头的包被提升到node_modules根目录，保证ESLint能正常找到插件。

• 统一本地与CI的pnpm版本：
  本地切换到pnpm 6.9.0，执行pnpm install重新生成兼容的pnpm-lock.yaml，再提交到仓库。

• 清理CI环境的缓存：
  在CI任务的安装步骤前，添加清理命令：

  rm -rf node_modules
  pnpm store prune
  

  确保依赖是完全重新安装的。

• 检查ESLint配置（可选）：
  若上述方法无效，可在ESLint配置文件中明确指定插件的解析路径：

  module.exports = {
    plugins: ['n'],
    settings: {
      'import/resolver': {
        node: {
          paths: ['./node_modules']
        }
      }
    }
  };
  

内容的提问来源于stack exchange，提问作者Balint Erdi