NPM 7/8安装本地npm包时未自动安装peerDependencies如何解决

npm v8.1.0 对本地路径安装的包默认采用软链接（symlink）形式挂载到宿主项目的node_modules中，这类被软链接的本地包会被npm判定为「开发中工作区包」，默认跳过peerDependencies的自动安装与冲突校验逻辑——这个行为是npm的设计使然，并非配置错误：npm默认假设本地包的开发者会自行在测试宿主项目中处理peer依赖，避免本地开发时出现重复安装、版本覆盖的问题。
你之前尝试的清空node_modules重装、固定peer依赖版本、将peer依赖同时写入dependencies的操作均未生效，核心原因就是没有改变本地包的软链接安装形式，npm始终没有按远程registry包的规则处理该包的依赖声明。
另外如果你的@me/eslint-config包的package.json中设置了"private": true，会进一步强化npm对其“本地私有包”的判定，完全跳过peer依赖的自动安装流程。

• 先确认本地包的安装形式：进入test-package下的node_modules/@me/目录，查看eslint-config的文件属性，如果是快捷方式/软链接，就符合上述触发条件。
• 方案1：安装时强制使用硬拷贝模式，触发常规peer依赖安装逻辑
  重新安装本地包时加上--install-links参数，命令如下：

  npm i ../eslint-config --save-dev --install-links
  

  该参数会让npm像处理远程包一样，将本地eslint-config包完整拷贝到当前项目的node_modules中，而非创建软链接，此时npm会正常执行peer依赖的版本校验与自动安装流程。
• 方案2：检查全局/项目级npm配置是否禁用了peer依赖自动安装
  执行以下命令查看peer依赖相关配置：

  npm config get legacy-peer-deps
  

  如果返回值为true，说明npm被设置为v6及更早版本的旧peer依赖处理模式，不会自动安装peer依赖，执行以下命令关闭该配置即可恢复默认行为：

  npm config set legacy-peer-deps false
  

• 方案3（本地调试ESLint配置包的推荐方案）：
  如果需要频繁修改eslint-config的配置内容，反复执行硬拷贝安装的效率很低，可以直接在test-package的package.json中显式声明所有和eslint-config匹配的peer依赖。这也是ESLint生态的通用约定：ESLint预设、插件类包的peer依赖本身就要求宿主项目直接安装对应版本的ESLint和相关插件，显式声明反而能避免后续使用时出现版本漂移、隐式安装版本不符合预期的问题。

内容的提问来源于stack exchange，提问作者Trevor Sears