phpstorm内置终端运行npm run dev必定卡在“compiling…”是因为其终端模拟层截断tty信号，导致hmr失效、服务假启动、端口占用且无输出；正确做法是改用系统终端执行，phpstorm仅用于编辑与调试。
别用 PhpStorm 内置终端执行 npm run dev —— 它会卡在 “Compiling…” 不动，不是编译慢，是 TTY 信号被截断导致服务假启动，端口占着、控制台没输出、HMR 彻底失效。
为什么 PhpStorm 内置终端运行 npm run dev 必定卡住
Vue CLI 和 Vite 都依赖完整 TTY 环境处理热更新信号（比如 SIGUSR2）、实时日志流和进程生命周期管理。PhpStorm 的终端模拟层不转发这些底层信号，只捕获 stdout/stderr 的静态片段，结果就是：进程看似在跑，实则挂起，浏览器白屏，改代码没反应。
这不是配置问题，是架构限制 —— PhpStorm 的终端定位是轻量命令执行，不是前端开发服务器托管环境。
- 现象：终端输出停在
Compiling...，无Compiled successfully或HMR enabled - 连带后果：端口（如 3000/5173）被僵尸进程占用，
lsof -i :3000能查到但 kill 不掉 - 错误本质：不是“没配好”，是“不该这么用”
正确启动方式：绕过 PhpStorm 终端，用系统终端 + IDE 只做编辑
让 PhpStorm 回归它最擅长的事：语法高亮、跳转、调试、重构。开发服务器交给系统终端管。
- 先关闭 PhpStorm 所有运行中的 npm 配置：
Run → Stop（顶部菜单，或快捷键Ctrl+F2/Cmd+F2） - 打开系统终端：
macOS/Linux用 Terminal，Windows用 PowerShell（不是 CMD，PowerShell 对 Node.js 兼容更稳） -
cd到项目根目录（确保有package.json），执行npm run dev或npm run serve（看脚手架约定） - 此时浏览器访问
http://localhost:xxx正常加载，修改文件自动刷新
注意：npm 命令必须在系统终端里首次启动；后续 PhpStorm 中的 “Run Configuration” 即使删光，也不影响已运行的服务。
vue-composition-api-best-practices
Vue 3 组合式 API 与
热门下载
相关下载
精品课程
相关推荐
/
热门推荐
/
最新课程
安装 Xdebug 并配置 phpstorm
共1课时 | 186人学习
3分钟内将Xdebug安装到PHP
共1课时 | 168人学习
Xdebug 入门指南：使用 PhpStorm 进行调试
共1课时 | 146人学习
