WebStorm项目启动失败主因是本地环境与配置未对齐：需手动指定Node.js解释器路径、确保node_modules安装完整、验证package.json脚本被正确识别，且注意.idea配置跨机器失效问题。
直接打开就能跑，但依赖不装、Node 版本不对、package.json 脚本没识别，项目十有八九会启动失败——不是 WebStorm 的问题，而是本地环境和配置没对齐。
打开项目前先确认 Node.js 路径是否已指定
WebStorm 不自动继承系统 PATH 里的 node，尤其当你用 nvm 切换版本时，IDE 很可能还在用旧版本或根本找不到 node。
- 进
File → Settings → Languages & Frameworks → Node.js（macOS 是WebStorm → Preferences） - 检查
Node interpreter是否指向你当前项目实际需要的node可执行文件，比如/Users/xxx/.nvm/versions/node/v18.18.2/bin/node - 如果用
nvm，且项目根目录有.nvmrc，建议在终端里先执行nvm use，再启动 WebStorm，否则 IDE 可能读不到正确版本 - 路径填错会导致后续所有 npm 操作报
Cannot find module 'npm'或直接卡在“Installing dependencies…”不动
依赖安装别只靠右键 Install，要盯住终端输出
WebStorm 提供了图形化入口（右键 package.json → Add Dependency 或点击文件顶部的绿色 Install 按钮），但它本质还是调 npm install 或 yarn install。静默失败很常见。
- 打开 WebStorm 内置终端（
Alt+F12），手动运行npm install或yarn install，观察输出是否有ERR!、ENOTFOUND、ETIMEDOUT - 如果卡在某个包，大概率是镜像源问题：进
Settings → Languages & Frameworks → Node.js and NPM，把Package repository改成https://registry.npmmirror.com/ - 某些项目依赖
python或build tools（如node-gyp），npm install报错时别硬等，看第一行错误关键词，比如gyp ERR!就得装 Python 和 VS Build Tools -
node_modules生成后，留意 WebStorm 左侧 Project 面板是否显示该文件夹——没出现说明安装中途失败或被 .gitignore 过滤了
运行脚本前必须确认 package.json 中 script 是否被识别
WebStorm 不会自动把 "serve": "vue-cli-service serve" 这类脚本当成可运行项，除非它明确出现在 Scripts 工具窗口里。
- 打开
package.json，等几秒，右上角应出现Scripts标签页（若没出现，重启 WebStorm 或手动触发File → Reload project from disk） - Scripts 窗口里没列出
serve、start、dev？检查package.json里是否拼错字段名，比如写成"scripts"漏了 s，或缩进用了中文空格 - 选中脚本 → 右键 →
Run，WebStorm 会自动生成一个npm类型的 Run Configuration；如果提示Script not found，说明脚本名和 package.json 不一致 - Vue/React 项目常用
serve或start，但有些定制脚手架用dev或watch，务必以package.json为准，别凭经验硬写
常见陷阱：.idea 文件夹被 git 忽略导致配置丢失
团队协作时，很多人把 .idea 加进 .gitignore，这本身没问题，但新成员 clone 后会丢失 Run Configuration、Code Style、Debugger 设置等——这些不会自动重建。
- 如果同事发来一个 “已配置好可直接 run” 的项目，而你打开后没有预设的运行配置，大概率是
.idea/runConfigurations/没提交 - 临时解决：自己新建一个
npm配置，Command填run，Scripts选对应脚本名，Working directory设为项目根目录 - 长期建议：团队统一决定哪些
.idea子目录需纳入 git（如.idea/runConfigurations/、.idea/codeStyles/），避免每人重配 - 注意：
.idea里含绝对路径（如 Node 解释器路径），跨机器导入时可能失效，需手动修正
真正卡住人的往往不是“怎么点”，而是“点完之后终端没反应、Scripts 窗口空、Run Configuration 找不到脚本”——这些问题全指向三个地方：Node 路径、package.json 结构、node_modules 是否真实存在。盯住终端输出，比反复点击界面更可靠。
