依赖安装失败
pnpm install 失败？90% 的问题出在这几个地方。
快速修复
bash
# 清除 pnpm 缓存
pnpm store prune
# 删除本地依赖
rm -rf node_modules pnpm-lock.yaml
# 重新安装
pnpm install如果还不行，继续往下看。
场景一：Node 版本过低
现象：报错 engine 或 unsupported
检查：
bash
node -v
# 需要 v18.x 或更高解决：
- 使用 nvm 切换：
nvm install 18 && nvm use 18 - 或直接安装 Node.js 18+ LTS
场景二：pnpm 版本过低
现象：报错 lockfile version
检查：
bash
pnpm -v
# 需要 8.x 或更高解决：
bash
npm install -g pnpm@latest场景三：网络问题
现象：下载超时或 ETIMEDOUT
解决：切换国内镜像
bash
# 切换淘宝镜像
pnpm config set registry https://registry.npmmirror.com
# 或使用项目级配置
echo "registry=https://registry.npmmirror.com" > .npmrc场景四：缓存损坏
现象：安装成功但运行报错
解决：
bash
# 清除全局缓存
pnpm store prune
# 强制重新安装
pnpm install --force场景五：权限问题（Linux/Mac）
现象：EACCES 或 permission denied
解决：
bash
# 方案 A：修改 npm 目录权限
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/Library/pnpm
# 方案 B：使用 sudo（不推荐）
sudo pnpm install场景六：依赖冲突
现象：报错 ERESOLVE 或版本冲突
解决：
bash
# 忽略依赖冲突（谨慎使用）
pnpm install --no-strict-peer-dependencies场景七：磁盘空间不足
现象：ENOSPC
解决：
- 清理磁盘空间
- 或更换 node_modules 存储位置
场景八：git clone 不完整
现象：某些依赖 404
检查：
bash
ls -la
# 确认 package.json 存在解决：重新克隆
bash
git clone https://gitee.com/youlaiorg/vue3-element-admin.git
cd vue3-element-admin
pnpm install场景九：Windows 长路径限制
现象：文件名过长错误
解决：以管理员身份运行 PowerShell
powershell
# 开启长路径支持
npm config set long_paths_enabled true场景十：杀毒软件拦截
现象：安装中途卡住或报错
解决：
- 临时关闭杀毒软件
- 或将项目目录加入白名单
仍然无法解决？
- 查看完整错误日志：
pnpm install --reporter default - 搜索报错信息：GitHub Issues
- 提交新 Issue，附上错误截图和 Node/pnpm 版本