webstorm 2023.3起默认启用项目安全模式，打开外部项目时仅允许浏览代码，需点击「trust project…」才能执行npm install、运行脚本等操作；信任后自动解析依赖并启用全部功能，且须确保node.js解释器已正确配置。
打开已有项目时直接信任，否则卡在安全模式
WebStorm 2023.3 起默认启用项目安全模式：打开外部导入的项目时，会阻止 npm install、运行脚本、调试等操作，只允许浏览代码。顶部会显示「Preview in Safe Mode」提示条，点击「Trust Project…」才能继续——不点它，后续所有运行配置都灰掉，连 package.json 右键菜单里的「Run npm install」都不会出现。
信任后，IDE 会自动解析依赖、加载插件、索引文件。若项目含 node_modules，建议先删掉再点信任，让 WebStorm 触发自动安装提示；否则可能因旧缓存导致路径识别异常（比如 ~@ 别名飘红）。
运行前必须确认 Node.js 解释器已绑定
即使项目能打开、package.json 显示正常，如果没指定 Node.js 路径，所有 npm 脚本都会报错：Cannot find Node.js 或 Command not found: npm。这不是环境变量问题，而是 WebStorm 自己没读到。
检查路径：进入 Settings | Languages & Frameworks | Node.js and NPM，右侧「Node interpreter」必须指向一个真实存在的 node 可执行文件（如 /usr/local/bin/node 或 C:\Program Files\nodejs\node.exe）。如果为空或显示「Not configured」，点击右侧文件夹图标手动选择。
常见坑点：
- 用了
nvm或fnm切换版本，但 WebStorm 仍指向系统默认 Node —— 需手动选当前 shell 中which node输出的路径 - macOS M1/M2 用户装了 Rosetta 版 Node，而 WebStorm 运行在原生 Apple Silicon 模式下，路径不兼容
- Windows 上 Node 安装路径含空格（如
Program Files），未用引号包裹，导致解析失败
用 Run Configuration 启动 dev server，别只靠终端
在终端敲 npm run dev 能跑，不代表 WebStorm 的运行配置就生效。真正集成调试、热重载、自动浏览器打开等功能，依赖的是 Run/Debug Configurations。
正确做法：
- 点击右上角「Add Configuration…」→ 「+」→ 选
npm -
Name填dev（或任意易识别名） -
package.json必须选中项目根目录下的那个（下拉列表里通常只有一个） -
Command填run，Scripts下拉选dev（不是serve或start，得看package.json里 scripts 字段实际写的 key） - 勾选「Run npm install」（首次运行时避免手动装依赖）
- 「After launch」里勾选「Open browser」并填
http://localhost:8080（Vue CLI 默认）或http://localhost:5173（Vite 默认）
保存后，右上角绿色三角按钮就变成这个配置，点一下就能启动 + 自动开浏览器。下次打开项目，该配置仍存在，不用重复设。
Vue 项目里 ~@ 飘红？配好 Webpack alias 才生效
WebStorm 不会自动读取 vue.config.js 或 vite.config.ts 里的 alias 配置，所以即使项目能正常编译运行，编辑器里 import Xxx from '~/components/Xxx.vue' 仍会标红，提示「Cannot resolve directory `~`」。
解决方法是手动告诉 WebStorm 别名映射：
- 进
Settings | Languages & Frameworks | JavaScript | Webpack - 「Webpack configuration file」选中项目根目录下的
webpack.config.js（Vue CLI）或vite.config.ts（Vite） - 如果没显式配置 webpack，但用了 Vue CLI，可点「Auto-detect」让 WebStorm 尝试从
node_modules/@vue/cli-service推导 - 对 Vite 项目，需确保
vite.config.ts中的resolve.alias是静态对象字面量（不能是函数返回值），否则 WebStorm 无法解析
改完等几秒，飘红自动消失。这步不影响运行，但影响跳转、补全和重构——漏掉它，Ctrl+Click 会跳到错误位置。
