phpstorm误删的运行配置可通过local history恢复,因其自动保存在.idea/runconfigurations/下的xml快照,默认保留5天;也可从git历史找回(若已提交),或手动重建但易遗漏关键参数。

PhpStorm 误删的运行配置(Run Configuration)能恢复,但不是靠“撤销”或回收站——它依赖 IDE 自动保存的本地历史快照,且必须在删除后尽快操作,否则可能被自动清理。
为什么 Run Configuration 被删后找不到入口
运行配置(如 PHP Script、PHPUnit、Web Server 等)实际存储在项目 .idea/runConfigurations/ 目录下,每个配置对应一个 XML 文件。误删通常指你在 Run → Edit Configurations… 界面里点了减号(−)并确认删除,此时文件被物理移除,IDE 不再显示该条目。
常见错觉是“配置还在缓存里”,但 PhpStorm 不会保留已删除配置的内存状态;它只对当前存在的配置做实时同步。
- 删除操作不会触发 Git 提交(除非你手动 commit
.idea/) -
.idea/默认被 Git 忽略,所以即使有仓库,runConfigurations/通常也不在版本控制中 - 如果项目是多人协作且共用配置,有人可能把配置提交到了
.idea/runConfigurations/,这时可从 Git 历史找回
从 Local History 恢复被删的 runConfigurations 文件
只要没清空 Local History,且删除时间在最近 5 天内(默认保留天数),就能找回原始 XML 文件。
操作路径很直接:
- 在项目根目录或任意空白处右键 → Local History → Show History
- 左侧时间线中找带
Deleted标记的条目,或滚动到删除操作前一刻的快照 - 展开右侧文件树,定位到
.idea/runConfigurations/xxx.xml(xxx 是你原来的配置名) - 双击该文件预览内容,确认是你要的配置(看
<option name="SCRIPT_PATH" value="..."></option>等关键字段) - 右键该文件 → Revert,文件将恢复到
.idea/runConfigurations/下
注意:Revert 是覆盖写入,如果该路径下已有同名新配置,会被替换——建议先手动备份现有 .idea/runConfigurations/ 再操作。
从 Git 历史或团队共享配置中找回
如果你的团队把 .idea/ 提交到了仓库,或你自己曾 commit 过运行配置,这是最稳妥的恢复方式。
- 打开 Git → Show History,切换到
.idea/runConfigurations/对应的文件 - 右键某次提交 → Revert Commit 或 Copy Revision to Clipboard,再粘贴回本地
- 如果只记得配置名但不确定文件名,可用命令行快速查找:
git log --oneline --grep="MyApiTest"(用配置名关键词搜索提交信息)
若 Git 里从未提交过该配置,这条路就走不通;但值得检查一次——很多人误以为 .idea/ 不能提交,其实部分配置(尤其是团队统一调试环境)是推荐纳入版本控制的。
重建配置时容易漏掉的关键参数
手动新建 Run Configuration 看似简单,但几个参数一错,就会导致启动失败或行为异常:
- PHP Script 类型:必须填对
Script path,且Working directory要设为脚本所在目录(不是项目根目录),否则require会报错 - PHPUnit:选错
Test runner(PHP script vs. Composer script),或Path to phpunit.phar指向错误位置,会导致“Class PHPUnit_Framework_TestCase not found” - Web Server:Host 和 Port 必须和你实际启动的服务器一致;若用内置服务器,
Use built-in web server要勾选,且Document root必须指向public/或web/目录 - 所有配置的
Environment variables和Before launch步骤(比如 “Run npm install”)一旦漏掉,就不是原来那个配置了
真正麻烦的不是删了配置,而是删完后凭记忆重填——那些隐藏在折叠面板里的小开关、路径变量($ProjectFileDir$)、甚至单引号/双引号的细微差异,都会让恢复后的配置“看起来一样,跑不起来”。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










