npm 依赖安装失败

区分锁文件、依赖冲突与仓库网络错误。

先确认项目使用的 Node/npm 版本和包管理器。已有 package-lock.json 的项目，优先按团队流程使用 npm ci 复现依赖，不要用 --force 掩盖冲突。

排查步骤

node --version
npm --version
npm config get registry

预期结果: 版本与项目要求一致，registry 指向预期服务。

npm ci

预期结果: 成功时依赖与锁文件一致；失败时保留首个 ERESOLVE 或网络错误。

npm ls --depth=0

预期结果: 能看到缺失或无效依赖；按实际冲突更新兼容版本与锁文件。

原因: peer dependency 的版本要求互不兼容。

处理方式: 阅读冲突双方及版本范围，选择兼容版本后重新生成锁文件。

原因: 到 registry 的连接失败。

处理方式: 核对 registry、代理、DNS 与网络连通性后重试；不要把网络故障当成依赖冲突。