webstorm npm install 报错

1. 先看完整报错，区分网络、权限还是依赖问题
   在 WebStorm 底部 Terminal 面板执行 npm install，报错后不要只看最后一行，向上滚动复制完整信息。常见三类：网络类（如 ECONNRESET、ETIMEDOUT、ENOTFOUND）说明连不上 npm 源；权限类（如 EACCES、EPERM）说明没有写目录权限；依赖类（如 ERESOLVE、peer 冲突）说明版本不兼容。先确认是哪一类，再按下面步骤处理。
2. 检查 npm 源并切换为国内镜像
   网络类报错大多因为默认源访问慢或不通。在 WebStorm 终端执行 npm config get registry，如果返回的不是 https://registry.npmmirror.com，可临时切换：npm config set registry https://registry.npmmirror.com。切换后重新 npm install。如果公司网络有代理，还需检查 npm config get proxy 和 https-proxy，必要时设为空。不要随便改其他配置，避免影响已有项目。
3. 清理 npm 缓存并删除 node_modules 后重装
   缓存损坏或残留旧依赖会导致 install 中途报错。先执行 npm cache clean --force，然后在项目根目录删除 node_modules 文件夹和 package-lock.json（如果存在）。删除时注意：在 WebStorm 左侧项目树中右键 node_modules 选择 Delete，或使用终端命令 rm -rf node_modules（Windows 用 rmdir /s /q node_modules）。完成后重新执行 npm install。此操作不会改代码，可放心执行。
4. 检查 Node.js 和 npm 版本，必要时升级
   部分依赖要求较高版本 Node 或 npm。在终端执行 node -v 和 npm -v，记录版本号。如果项目 package.json 里 engines 字段指定了版本范围，需确保当前版本满足。不满足时，建议通过 Node 官网或 nvm 安装对应 LTS 版本，然后在 WebStorm 中打开 Settings（或 Preferences）→ Languages & Frameworks → Node.js，将 Node interpreter 指向新版本。不要用 npm 直接升级 Node，容易破坏环境。
5. 以管理员身份运行 WebStorm 并检查目录权限
   权限类报错（EACCES、EPERM）多因项目目录或全局 node_modules 无写权限。Windows 上可右键 WebStorm 图标选择「以管理员身份运行」，再执行 npm install。macOS/Linux 可检查项目目录归属：ls -ld 项目路径，若属主不是当前用户，执行 sudo chown -R 当前用户名 项目路径。注意不要对整个系统目录使用 chmod 777，避免安全隐患。如果项目在系统盘（如 C:Program Files）下，建议移到用户目录。
6. 查看 WebStorm 内置终端是否使用正确 Shell 和环境变量
   有时报错是因为 WebStorm 内置终端没有继承系统环境变量，导致 npm 找不到。打开 Settings → Tools → Terminal，查看 Shell path 是否为系统默认（Windows 一般为 cmd.exe 或 powershell.exe，macOS 为 /bin/zsh）。如果之前改过，恢复默认。然后关闭并重新打开终端，执行 npm config list 确认配置生效。若仍报错，可尝试在系统终端（非 WebStorm）执行 npm install，若成功则说明问题出在 WebStorm 终端配置上。

软件页面：Webstorm。