WebStorm不决定React启动模式，切换至Vite需三步同步：删react-scripts、装vite与@vitejs/plugin-react、改package.json的start脚本为"vite"或"vite dev"，并确保vite.config.ts含react()插件及index.html挂载点匹配；WebStorm中右键package.json运行start或配置NPM运行项（勾选Run in new terminal、设对工作目录和Node路径）即可生效。
WebStorm 本身不决定 React 项目的启动模式（如开发服务器是 Vite、Webpack 还是 Next.js），它只负责执行 package.json 中定义的脚本；切换启动模式的关键在于改脚本、换依赖、调配置，而不是在 WebStorm 里点某个菜单。
怎么改 start 脚本才能切到 Vite 模式
如果你当前项目是 create-react-app（即 react-scripts start），但想换成 Vite，不能只改 WebStorm 的运行配置——得先落地换工具链：
- 删掉
react-scripts依赖：npm uninstall react-scripts - 装 Vite 和 React 插件：
npm install -D vite @vitejs/plugin-react - 新建
vite.config.ts，内容至少含plugins: [react()] - 把
package.json的"start"改成："vite"或"vite dev" - 确保
index.html存在且挂载点匹配（Vite 默认找#root，和 CRA 一致）
改完后，在 WebStorm 里右键 package.json → Run start，或进 Run > Edit Configurations 新建一个 NPM 配置，Command 填 start，就能跑 Vite 了。
Run > Edit Configurations 里哪些设置影响启动行为
这个界面不改启动模式，但会决定 WebStorm 怎么“启动”那个模式：
- 必须勾选
Run npm script in new terminal：否则终端输出可能被截断，Vite 的 HMR WebSocket 连不上，热更新就失效 - Working directory 必须设为项目根目录（含
package.json）：否则npm start找不到脚本或依赖 - Node interpreter 要指向你项目实际用的 Node 版本（比如通过 nvm 或 fnm 切的）：版本错会导致
vite命令找不到或插件加载失败 - 不要手动填 “Command line” 为
npx vite：应始终走npm start，让 package.json 统一管控，避免 IDE 和 CLI 行为不一致
为什么改了脚本，WebStorm 还是报错或不识别 JSX
这不是启动模式的问题，而是 WebStorm 没重新“认出”这是个 React 项目：
- 检查右下角状态栏：当前文件的语言模式是不是
React JSX？不是就右键文件 →Override File Type→ 选JavaScript或TypeScript JSX - 确认
package.json里有react和react-dom（哪怕只是devDependencies），否则 WebStorm 不激活 JSX 支持 - 如果用了 TypeScript，
tsconfig.json的"jsx"字段必须是"preserve"或"react-jsx"，否则类型推导和自动补全会断 - 删掉
node_modules/.idea并重启 WebStorm：旧索引残留常导致语言服务卡在旧模式
真正难的不是点哪几个按钮，而是每次换启动模式时，要同步更新三处：package.json 脚本、实际安装的依赖、以及 WebStorm 对项目语义的理解（靠依赖+配置文件触发）。漏一处，IDE 就会“假装没看见”你在用 Vite。
