PhpStorm内置终端运行npm run dev卡住、无日志、热更新失效，根本原因是非登录shell未加载shell配置导致PATH缺失，TTY信号被IDE模拟层截断，且Open in Browser误导向63342端口；应改用登录shell启动终端、用Run Configuration替代手动执行、并手动访问localhost:5173。
PhpStorm 里直接在内置终端运行 npm run dev 卡住、没日志、热更新失效，不是命令写错了，而是终端环境没加载 shell 配置、TTY 信号被截断、或进程被 IDE 模拟层阻塞了。
终端执行 npm run dev 报 “command not found” 怎么办
根本原因是 PhpStorm 内置终端以非登录 shell 启动，跳过了 ~/.zshrc 或 ~/.bash_profile，导致 npm 和 node_modules/.bin 不在 $PATH 里。
- 打开 Settings → Tools → Terminal，把
Shell path改成/bin/zsh -l（macOS/Linux）或powershell.exe -NoExit（Windows） - 关闭当前终端 tab，新开一个，运行
echo $PATH，确认输出里含node_modules/.bin和全局 npm bin 路径（如/usr/local/bin） - 再试
npm --version和npx vite --version，都成功才说明 PATH 正确
为什么 npm run dev 在终端里卡在 “Compiling…” 不动
这不是服务没启动，是 PhpStorm 终端模拟层无法转发 TTY 信号（比如 SIGUSR2），Vite 或 Vue 的 HMR 机制依赖这些信号触发重编译，一被截断就挂起。
- 现象包括：控制台只打印一行 Compiling、浏览器打不开
http://localhost:5173/、lsof -i :5173查不到进程 - 别硬等，直接关掉这个终端 tab
- 改用系统终端（macOS Terminal / Windows PowerShell / GNOME Terminal）执行
npm run dev—— PhpStorm 只负责编辑和调试，不负责托管开发服务器
想在 PhpStorm 里一键运行 npm run dev 该怎么配运行配置
用 Run Configuration 替代终端手动敲，能避免环境变量污染、进程生命周期混乱、端口冲突等问题。
立即学习“PHP免费学习笔记（深入）”；
- 右上角点击 Add Configuration → Add New Configuration → npm
-
Package.json选项目根目录下的文件；Command填run；Scripts选dev（对应package.json里的"dev": "vite"） - 务必勾选 Run npm script in new terminal，否则可能复用旧终端导致 PATH 或 NODE_ENV 错乱
- 不要保留任何
JavaScript Debug类型的配置——它会强制启用http://localhost:63342/代理，和 Vite 的5173端口冲突，导致 HMR 请求被劫持
浏览器打不开 http://localhost:5173/ 或热更新不生效
90% 是因为误点了 PhpStorm 右上角的 Open in Browser 按钮，它默认打开的是 IDE 内置服务地址 http://localhost:63342/，而不是 Vite 真实监听的地址。
- Vite 启动后第一行输出一定是类似
✓ Local: http://localhost:5173/的真实 URL，必须手动复制粘贴进浏览器 - 如果已点过 Open in Browser，检查浏览器地址栏是不是
63342开头，是的话就说明请求被 IDE 代理拦截了，模块路径解析失败、HMR 元数据拿不到 - 删掉所有
JavaScript Debug配置，只留 npm 类型，并确保dev脚本没被重写成vite --host之类带额外参数的变体（除非你明确需要）
最常被忽略的一点：Vite 的热更新是否生效，和 PhpStorm 是否“识别 vite.config.ts”无关，而取决于它有没有真正跑起来。只要终端里看不到 5173 端口监听、浏览器访问不到，其他所有配置都是白搭——先让服务活过来，再谈智能提示和跳转。
