run dashboard 不见是因为 .idea/workspace.xml 中缺失 rundashboard 组件配置,需手动插入 xml 片段并重启;它只显示永久运行配置,不识别临时配置或未正确绑定生命周期的服务。

PhpStorm 的 Run Dashboard 默认不启用,尤其在新项目或旧版本升级后容易缺失;必须手动补全 RunDashboard 配置项才能显示服务列表并支持批量启停。
为什么 Run Dashboard 不见了?
常见原因不是插件未启用,而是项目级配置缺失。PhpStorm 不会自动往 .idea/workspace.xml 写入 RunDashboard 组件 —— 即使你装了 Spring Boot 插件、开了 Services 工具窗口,只要这个 XML 片段没存在,Dashboard 就不会出现。
- 检查路径:
.idea/workspace.xml,搜索<component name="RunDashboard"></component>,若无结果即未启用 - 仅靠
View → Tool Windows → Run Dashboard点击无效,菜单项灰显或点击无响应都说明底层配置未就位 - 该组件只对“已识别为运行配置类型”的服务生效,比如
SpringBootApplicationConfigurationType,普通 PHP 脚本或 Shell 命令不会自动归入
如何手动注入 Run Dashboard 配置
直接编辑 .idea/workspace.xml,在 <project version="4"></project> 根节点内(通常靠近末尾)插入以下 XML 片段:
<component name="RunDashboard"><option name="configurationTypes"><set><option value="SpringBootApplicationConfigurationType"></option> <option value="PhpScriptConfigurationType"></option> <option value="JavaScriptDebugType"></option></set></option> <option name="ruleStates"><list><rulestate><option name="name" value="ConfigurationTypeDashboardGroupingRule"></option></rulestate><rulestate><option name="name" value="StatusDashboardGroupingRule"></option></rulestate></list></option></component>
- 注意:若项目含 PHP 服务,务必加入
PhpScriptConfigurationType;前端项目则加JavaScriptDebugType - 修改后需重启 PhpStorm 或重新加载项目(
File → Reload project from Disk),否则不生效 - 配置保存后,
Run Dashboard菜单项变亮,且窗口中会按类型分组列出所有匹配的运行配置
启动多个服务时,为什么有的不显示在 Dashboard 中
Dashboard 只展示「已创建为永久运行配置」的服务 —— 临时配置(右键文件 → Run)即使正在运行,也不会出现在 Dashboard 列表里。
- 确认每个服务都已保存为永久配置:运行一次后,在
Run → Edit Configurations…中找到它,图标不透明即为永久;半透明则是临时 - 临时配置最多保留 5 个,超出后会被自动清理,Dashboard 完全无视它们
- 若服务使用了自定义脚本(如
docker-compose up),需新建Shell Script类型的永久配置,并勾选Allow parallel run,否则 Dashboard 无法识别为可管理服务 - Spring Boot 项目还需确保
spring-boot-devtools未干扰启动逻辑,否则部分配置可能被跳过注册
Dashboard 启停服务失败的典型表现与修复
点击 Stop 按钮无反应,或状态卡在 “Running” 但进程实际已退出,多数是进程未正确绑定到 IDE 的生命周期管理。
- Java/Spring Boot 服务:检查启动配置的
JRE是否为项目 SDK,而非系统默认 JDK;否则kill -15信号可能无法送达 JVM - PHP CLI 服务:避免用
php -S直接监听0.0.0.0:8000,应改用php -S localhost:8000,否则 IDE 无法通过端口探测判断存活状态 - 终端类服务(如 Node dev server):在运行配置中启用
Before launch → Run Another Configuration并勾选Wait for it to finish,否则 Dashboard 可能误判启动完成时间 - 最隐蔽的坑:Linux/CentOS 上若启用 SELinux,
supervisord或容器进程可能被拦截,导致 Dashboard 显示 “Stopped” 实际仍在后台跑 —— 此时需查ausearch -m avc -ts recent
Dashboard 的核心价值不在“看起来整齐”,而在于统一收口进程生命周期。一旦配置写死在 workspace.xml 里,它就不再依赖 UI 状态或插件开关,即使断电重开也能恢复服务视图 —— 但前提是,每个服务都得是 IDE 认得出来的“合法居民”。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










