npm install 在 WebStorm 中真正生效的途径只有两种：一是在底部 Terminal 手动执行 npm install；二是首次导入项目时勾选弹出的“Install dependencies”提示框中的 Run npm install 选项。
npm install 在 WebStorm 里点哪里才真正生效
WebStorm 不会自动运行 npm install，哪怕你刚 clone 下来一个 Vue 项目、node_modules 是空的，IDE 也不会主动帮你装依赖。常见错误是双击 package.json → 点开 scripts 里的 install 或直接右键 run，结果报错 command not found: vite 或 Cannot find module 'vue'。
正确做法只有两种：
- 在 WebStorm 底部
Terminal里手动敲npm install（推荐，可控、有完整输出） - 导入项目时，当弹出 “Install dependencies” 提示框，勾选
Run npm install并确认——这个动作只在首次打开项目时出现，错过就没了
别依赖右键菜单里的 “Run ‘npm install’”，它可能用错 Node.js 版本或工作目录。
依赖装一半失败？先核对 Node.js 和 npm 版本
Vue3 + Vite 项目普遍要求 Node.js ≥ 18.0.0；若你用 nvm 切换过版本，但 WebStorm 没同步识别，就会卡在 npm install 报各种奇怪错误，比如：
立即学习“前端免费学习笔记（深入）”；
-
error code CERT_HAS_EXPIRED→ 执行npm config set strict-ssl false临时绕过（仅限内网/可信环境） -
openssl-legacy-provider相关报错 → 在 WebStorm 的运行配置里，Environment variables加上NODE_OPTIONS=--openssl-legacy-provider - 一堆
peer dep missing→ 用npm install --legacy-peer-deps强制安装（适合快速验证，非长期方案） - 镜像源失效 → 改为国内源：
npm config set registry https://registry.npmmirror.com
检查当前生效的 Node.js 版本：在 WebStorm Terminal 里运行 node -v && npm -v，结果必须匹配项目要求。
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
Vue 项目启动失败，但依赖看似已装好？查 vue-cli-service 或 vite 脚本配置
报错如 Error: Cannot find module '../package.json' 或 Missing script: "dev"，本质是脚本没被正确识别或执行路径错乱。
关键细节：
- 如果项目用
vite，package.json里"dev": "vite"是对的，但在 WebStorm 新建 npm 运行配置时：
—Command必须填run（不是vite，也不是dev）
—Scripts下拉框必须选中你定义的脚本名，比如dev、serve或start
—Package必须指向项目根目录下的package.json，而不是父目录或其他位置的同名文件 - 如果项目用
yarn，就选yarn类型配置，Command填run，Scripts同样选脚本名
运行配置里漏掉任一环，都会导致命令找不到或模块加载失败。
为什么 yarn install 总是中断或缺失模块
yarn install 失败往往不是命令本身问题，而是底层状态不一致：
-
yarn.lock文件损坏或合并冲突后手动编辑过 → 删除yarn.lock，再跑一次yarn install - 本地 yarn 缓存异常 → 清理：
yarn cache clean - 权限问题（尤其 Windows 上杀毒软件拦截
node_modules写入）→ 临时关闭实时防护，或以管理员身份运行 Terminal - yarn v1 与 v2+ 混用 → 检查
yarn --version，团队项目统一用 v1（yarn set version classic）更稳妥
最隐蔽的坑是：WebStorm 默认调用的是系统 PATH 里的 yarn，但它可能和你项目期望的版本不一致——建议在运行配置里显式指定 Node interpreter 和 yarn 可执行路径。
