PhpStorm 启动 Vite 失败、HMR 不生效，主因是 Node.js 解释器未正确绑定、TS 版本未设为项目级、运行配置误用 JavaScript Debug；需配置项目级 Node 和 TypeScript、用 npm run dev 启动、手动访问 http://localhost:5173/。
PhpStorm 启动 Vite 开发服务器失败、HMR 不生效，大概率不是 Vite 配置问题，而是运行方式和 IDE 服务冲突导致的。
PhpStorm 里点绿色三角运行 vite 报错 “Command 'vite' not found”
根本原因不是没装 vite，而是 PhpStorm 默认不把 node_modules/.bin 加入 PATH，且 Node.js 解释器未正确绑定到项目级环境。
- 打开
Settings → Languages & Frameworks → Node.js and NPM，确认Node interpreter指向你项目实际使用的node（如/usr/local/bin/node或C:\Program Files\nodejs\node.exe） - 在项目根目录终端执行
npm install（或pnpm install），确保node_modules/.bin/vite真实存在 - 别依赖全局安装的
vite：全局版本与devDependencies中的版本不一致时，类型推导、跳转、HMR 元数据都会出错
启动后浏览器打不开 http://localhost:5173/ 或热更新失效
这是 PhpStorm 内置静态服务器（http://localhost:63342/）和 Vite 开发服务器端口冲突的典型表现。两个服务同时监听、互相劫持模块请求，导致 HMR 请求被代理拦截、import 路径解析失败。
HISUI 前端框架开发指南（IRIS版）
下载
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
- 删掉所有类型为
JavaScript Debug的运行配置——它会强制启用内置服务，与 Vite 互斥 - 新建一个
npm运行配置：Command填run，Scripts选dev（对应package.json里的"dev": "vite"） - 勾选
Run npm script in new terminal，避免复用已有终端导致环境变量污染 - 浏览器必须手动访问
http://localhost:5173/（Vite 输出的真实地址），不要点 PhpStorm 右上角的Open in Browser
vite.config.ts 里 defineConfig 报红、TS 类型推导不准
PhpStorm 默认用内置 TypeScript 服务，而非你项目 node_modules/typescript 的版本，导致 defineConfig 缺失类型、import 补全失效、resolve.alias 跳转失败。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Languages & Frameworks → TypeScript，把TypeScript version改为Project preferences，并手动指向node_modules/typescript - 在
vite.config.ts文件顶部加// @ts-check，强制启用类型检查 - 如果仍报
Cannot find name 'defineConfig'，别等自动导入，手动写import { defineConfig } from 'vite' - 确保
@types/node版本匹配 Vite：例如 Vite 5.x 推荐@types/node^20.10.0，否则路径解析和全局类型会漏判
真正卡住人的地方往往不在 vite.config.ts 写得对不对，而在于 PhpStorm 是否“认出”了这是个 Vite 项目——它不会自动扫描 package.json 里的 devDependencies，必须靠正确的 Node.js 解释器 + 项目级 TS 版本 + 纯 npm 运行配置三者联动，缺一不可。
