npm install 失败怎么办？

运行 npm install 报错，依赖装不上

解决方案

清除缓存并重新安装推荐

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

删除 node_modules 和 lock 文件，清除缓存后重新安装。解决大部分安装问题。

适用场景：不确定具体原因，先试这个万能方案

切换国内镜像

npm config set registry https://registry.npmmirror.com
npm install

网络问题导致下载失败时，切换到国内镜像源可以解决。

适用场景：报错信息包含 network、timeout、ECONNRESET

解决依赖冲突

npm install --legacy-peer-deps

npm 7+ 对 peer dependencies 更严格，加 --legacy-peer-deps 使用旧的宽松策略。

适用场景：报错信息包含 ERESOLVE、peer dep、conflicting

修复权限问题

# 方案 1：修改 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# 将 ~/.npm-global/bin 加入 PATH

# 方案 2：使用 nvm 管理 Node
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

全局安装时 EACCES 权限错误，推荐用 nvm 管理 Node 或修改 npm prefix。

适用场景：报错信息包含 EACCES、permission denied