NPM：如何基于单个项目强制启用legacy peer deps？

针对 npm（适用于所有npm版本） #

有两种方式可以为单个项目配置：

• 修改package.json：在项目根目录的package.json中添加npmConfig字段，指定启用legacy peer deps：

{
  "name": "你的遗留项目名称",
  "version": "1.0.0",
  // 保留项目原有其他配置字段
  "npmConfig": {
    "legacy-peer-deps": true
  }
}

• 创建.npmrc文件：在项目根目录新建.npmrc文件，添加以下内容：

legacy-peer-deps=true

针对 Yarn 1.x（Classic Yarn，遗留项目常用版本） #

同样有两种配置方式：

• 创建.yarnrc文件：在项目根目录新建.yarnrc文件，写入：

--legacy-peer-deps true

• 修改package.json：在package.json中添加yarnConfig字段：

{
  "yarnConfig": {
    "legacy-peer-deps": true
  }
}

配置完成后，重新执行npm install或yarn install，包管理器就会以兼容遗留peer依赖的模式处理依赖安装，解决旧项目中因peer依赖版本不匹配导致的安装失败问题。

内容的提问来源于stack exchange，提问作者chrisl-921fb74d