问题现象

在 view/admin/、view/store/ 或 view/uniapp/ 执行 npm install 安装前端项目依赖时，终端抛出大量报错，例如：

• node-sass: Command failed 或 gyp ERR! build error
• ERESOLVE unable to resolve dependency tree
• npm ERR! code ETARGET 或网络连接超时。

---

根本原因与解决方案

Node.js 版本兼容性要求（最核心）

• 现象：系统前端基于 Vue 2.6 及相关 Webpack 插件开发，部分底层依赖（如 node-sass、fibers）对 Node.js 版本有严格上限。
• 推荐版本：
  • 最佳推荐：Node.js 14.x 或 16.x LTS（建议使用 v14.18.0 ~ v16.18.0）。
  • 若当前环境为 Node 18+，容易因 OpenSSL 3.0 或 C++ 扩展编译失败而报错。
• 切换版本工具（nvm）：

  nvm install 16.18.0
  nvm use 16.18.0

---

npm 7+ 依赖树冲突（--legacy-peer-deps）

Node 16+ 自带的 npm 7/8 在解析 peerDependencies 时极其严格：

npm install --legacy-peer-deps

---

配置国内 npm 镜像源加速

如果由于国外源网络超时导致下载失败，可切换至腾讯云或淘宝镜像源：

npm config set registry https://mirrors.cloud.tencent.com/npm/
npm config set registry https://registry.npmmirror.com

---

彻底清理缓存并重试

# 删除 node_modules 和 package-lock.json
rm -rf node_modules package-lock.json
npm cache clean --force
npm install --legacy-peer-deps

依赖安装成功后，即可执行 npm run build 或 npm run dev 正常开发构建。