npm error code ERESOLVE

### 解决 npm 安装时出现的 ERESOLVE 错误

当遇到 `npm ERR! code ERESOLVE` 错误时，这表明在解析依赖关系时遇到了问题。此错误通常发生在执行 `npm install` 或者 `npm ci` 命令期间[^2]。

#### 使用 legacy peer deps 参数

一种常见的解决方案是在安装命令后加上 `--legacy-peer-deps` 参数来绕过对等依赖中的冲突。这样做可以使得 npm 忽略不同包之间的版本差异并按照旧版的行为继续处理请求：

npm install --legacy-peer-deps

对于特定软件包也可以采用同样的方式：

npm install package-name --legacy-peer-deps

这种方法允许使用类似于 npm 4 到 6 版本的工作流程，在这些版本中不会强制解决所有的同级依赖关系[^5]。

#### 调整 npm 配置选项

如果希望在整个项目范围内应用这一行为而无需每次都指定参数，则可以通过设置配置文件或环境变量实现这一点。例如，可以在 `.npmrc` 文件内加入如下行以永久启用该特性:

legacy-peer-deps=true

此外还可以通过 CLI 设置临时性的全局偏好:

npm config set legacy-peer-deps true

之后再运行正常的 `npm install` 即可[^4]。

#### 尝试降级 npm 版本

有时升级后的 npm 可能会对某些项目的兼容性造成影响，因此考虑回退到更稳定的较早版本也是一个可行的选择之一。不过需要注意的是不必完全卸载当前已有的新版本，而是利用 `npx` 工具指明所需的具体版本号来进行操作：

npx -p npm@6 npm i --legacy-peer-deps

上述指令会在不改变本地环境中现有 npm 的情况下调用第 6 版本来完成此次安装任务。

#### 更新所有依赖至最新稳定版

最后，尝试更新整个应用程序及其全部外部库到最新的可用发行版或许能够从根本上解决问题。当然在此之前务必先备份好源码以及仔细阅读官方文档确认迁移指南。

npm update

或者更加激进地重写锁定文件从而获取最前沿的状态（需谨慎对待）：

rm package-lock.json && rm -rf node_modules && npm cache clean --force && npm install

以上措施应该可以帮助缓解大多数由 `ERESOLVE` 引发的情况[^3]。