根本原因是依赖未安装，webstorm不会自动执行npm install；唯一可靠方式是底部terminal中cd至项目根目录后手动运行npm install，或首次导入时勾选“install dependencies”提示框中的run npm install选项。
WebStorm导入Vue项目后 node_modules 为空、运行报 Cannot find module 'vue' 或 command not found: vite，根本原因只有一个：依赖压根没装上。IDE不会自动补救，必须手动触发安装，且路径、Node.js 版本、命令上下文都得对。
npm install 在 WebStorm 里点哪里才真正生效
WebStorm 不会主动执行 npm install，哪怕你刚 clone 下来一个完整 Vue 项目，node_modules 是空的，它也只会安静地等你动手。
- 唯一可靠方式：打开底部
Terminal，cd 到项目根目录（确保package.json在当前路径），手动运行npm install（或yarn install/pnpm install） - 唯一一次“自动”机会：首次导入项目时弹出的
Install dependencies提示框，必须勾选Run npm install并确认——错过就没了，之后再也不会出现 - 别信右键
package.json→Run 'npm install'：它可能用错 Node.js 解释器、工作目录错误，或根本没读取到package.json中的scripts定义
装一半失败？先看 Node.js 和 npm 版本是否匹配
Vue 3 + Vite 项目普遍要求 Node.js ≥ 18.0.0。若你用 nvm 切过版本，但 WebStorm 没同步识别，就会在 npm install 过程中卡住，报各种看似无关的错误。
- 在 WebStorm 的
Terminal中运行node -v && npm -v，确认输出的版本号符合项目要求 - 若版本低，去
Settings → Languages & Frameworks → Node.js and NPM，手动指定正确的 Node.js 路径（比如~/.nvm/versions/node/v20.15.0/bin/node） - 常见报错如
CERT_HAS_EXPIRED：临时执行npm config set strict-ssl false（仅限内网可信环境） -
openssl-legacy-provider报错：在运行配置的Environment variables中添加NODE_OPTIONS=--openssl-legacy-provider - 一堆
peer dep missing：加--legacy-peer-deps强制通过，例如npm install --legacy-peer-deps
装完还是找不到模块？检查 IDE 是否识别了 node_modules
依赖装好了，但 WebStorm 仍提示 Cannot find module 'vue' 或模板无语法提示，问题往往不在安装本身，而在 IDE 的索引和语言服务配置。
- 确认
node_modules没被误标为Excluded：右键目录 →Mark Directory as→ 确保不是Excluded（这个操作会破坏类型解析，尤其对 Vue SFC 和 TypeScript） - 正确做法是全局忽略索引：进入
Settings → Editor → File Types → Ignored Files and Folders，末尾追加node_modules;（注意分号），然后Invalidate Caches and Restart - 确保 Volar 插件已启用、Vue.js 插件已禁用：Volar 才是 Vue 3 的语言服务核心，冲突会导致
defineProps、ref等无类型推导 - 检查
Settings → Languages & Frameworks → JavaScript → Libraries，不要手动把node_modules加为 Library root——这会引发重复索引和类型混乱
最常被忽略的一点：装依赖不是一次性动作，而是环境链上的关键一环。Node.js 版本、包管理器命令、IDE 的解释器配置、插件启用状态，四者必须咬合。少一个齿轮，node_modules 就只是个空文件夹，而不是项目运行的根基。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
