PhpStorm运行前端构建工具卡住_排查Webpack或Vite执行死锁【分析】-phpstorm-PHP中文网

phpstorm运行webpack/vite卡在“starting...”主因是环境与配置未对齐：node解释器未绑定、node_modules未excluded、inotify句柄耗尽、运行配置误用javascript debug或node.js类型路径错误。

phpstorm运行前端构建工具卡住_排查webpack或vite执行死锁【分析】

PhpStorm 运行 Webpack 或 Vite 时卡在“Starting...”“Loading...”或终端无输出，基本不是构建工具本身挂了，而是 IDE 的运行配置和环境隔离没对齐——常见表现是进程启动后就静默、HMR 不触发、浏览器打不开，甚至 npm run dev 在终端里能跑，但在 PhpStorm 里点 ▶️ 就卡住不动。

Webpack 启动卡在 “Starting webpack-dev-server…”

这不是 webpack 没起来，是 PhpStorm 没真正把控制权交给它，或者 devServer 配置被 IDE 的代理逻辑劫持了。

devServer.hot 必须显式设为 true（Webpack 5+ 默认开启，但老项目常被关掉；光勾 IDE 的 “Use Hot Swap” 没用）
devServer.watchFiles 如果设置了，得覆盖你编辑的路径，比如 ['src/**/*', 'public/**/*']；漏掉任意一类，变更就不会触发重编译
别用 “JavaScript file” 类型运行配置——它会直接执行 webpack.config.js，而不是启动 devServer。正确做法是：Run Configuration → Node.js 类型 → JavaScript file 填 node_modules/webpack-cli/bin/cli.js，Application parameters 填 --config webpack.config.js --mode development
如果用了 pnpm，路径不是 node_modules/webpack-cli/bin/cli.js，而是类似 node_modules/.pnpm/webpack@5.92.1/node_modules/webpack-cli/bin/cli.js，必须手动补全，抄错版本号就卡住

Vite 启动卡在 “vite is starting…” 或终端空转

根本原因通常是 Node 环境没绑定、命令没找到，或 PhpStorm 内置服务和 Vite 开发服务器端口冲突。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

Command 'vite' not found 错误：不是没装 vite，而是 PhpStorm 没把 node_modules/.bin 加入 PATH。确认 Settings → Languages & Frameworks → Node.js and NPM → Node interpreter 指向项目实际用的 node（如 /usr/local/bin/node），再确保 node_modules/.bin/vite 存在
浏览器打不开 http://localhost:5173/ 或热更新失效：删掉所有类型为 JavaScript Debug 的运行配置——它会强制启用 PhpStorm 内置静态服务（http://localhost:63342/），和 Vite 的 localhost:5173 冲突，互相劫持模块请求
必须新建 npm 运行配置：Command 填 run，Scripts 选 dev（对应 package.json 里的 "dev": "vite"），并勾选 Run npm script in new terminal，避免复用终端导致环境变量污染
启动后仍卡住？检查系统级 _JAVA_OPTIONS 是否被设置（常见于 /etc/profile 或 ~/.bashrc），它会导致 PhpStorm 渲染异常、参数冲突，启动日志会显示 Picked up _JAVA_OPTIONS

卡住时 CPU 低、磁盘静默，其实是索引死锁

表面看是构建命令卡住，实际是 PhpStorm 还在后台拼命索引 node_modules 或 vendor，导致资源耗尽、inotify 句柄占满，连文件变更都监听不到。

打开 Help → Show Log in Explorer，搜 Indexing started 和 Indexing finished —— 如果后者迟迟不出现，说明索引根本没结束，构建进程被阻塞
检查 File → Project Structure → Modules，确认 node_modules、vendor、dist、storage 全部标为 Excluded（图标为红色，灰色 = 仍监听）
Linux 下查 inotify 限制：cat /proc/sys/fs/inotify/max_user_watches，默认 8192 不够一个 node_modules；永久改：写入 /etc/sysctl.d/60-jetbrains.conf，内容为 fs.inotify.max_user_watches=524288，再执行 sudo sysctl -p --system
标记 Excluded 后必须重启 PhpStorm，仅重载项目无效；改完 phpstorm64.vmoptions 也一样，热重载不生效