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 版本或工作目录
vite 项目里 package.json 的 dev 脚本必须匹配运行配置
很多同学照着网上教程配了 "dev": "vite"，但在 WebStorm 新建 npm 运行配置时，Command 栏误填成 vite 或 dev，导致启动失败，报错 Unknown script "vite" 或 Missing script: "dev"。
关键细节：
-
Command必须填run（不是vite，也不是dev） -
Scripts下拉框必须选中你package.json里定义的脚本名，比如dev、serve或start - 确保
Package指向的是项目根目录下的package.json，而不是父目录或其他位置的同名文件 - 如果项目用
yarn，就选yarn类型配置，Command填run，Scripts同样选脚本名
依赖装一半失败？先看 npm 和 Node.js 版本是否对得上
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，结果必须和项目 .nvmrc 或 engines 字段一致。
node_modules 更新后 WebStorm 没反应？手动触发索引刷新
装完依赖后，WebStorm 可能还标着 Cannot find module 'vue' 或无法跳转组件，不是代码问题，是 IDE 缓存没更新。
别重启整个 IDE，浪费时间。直接做三件事：
- 点击右下角状态栏的
indexing...或123 files indexed，等它变灰后，点旁边的齿轮图标 →Rebuild project index - 或者按快捷键
Ctrl+Shift+O（Windows/Linux）或Cmd+Shift+O（macOS），强制重载 JavaScript 语言服务 - 如果
node_modules是从别处复制过来的（比如 rsync 或手动拖入），WebStorm 可能把它标记为“excluded”，要去Project Settings > Project Structure里取消 exclude
真正容易被忽略的点：WebStorm 的 TypeScript 语言服务依赖 node_modules/.pnpm 或 node_modules/vite 下的真实路径做类型推导，一旦索引卡住，<script setup></script> 里的类型提示和断点调试都会失灵——这不是 Vue 问题，是 IDE 状态没跟上。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
