PhpStorm误删文件可通过Local History恢复,前提是文件曾被IDE跟踪并保存过、未超默认5天保留期;右键Show History灰显是因路径不在项目根目录、未保存、焦点不在编辑器或被忽略规则排除。

PhpStorm 误删的文件能恢复,但不是靠系统回收站或 Ctrl+Z —— 它依赖 IDE 自动维护的 Local History 快照,只要文件曾被 PhpStorm 跟踪、保存过,且删除时间没超过默认保留天数(5 天),就能找回。
为什么右键 Local History → Show History 是灰的或没反应
这不是功能失效,而是当前上下文不满足快照生成条件:
- 文件路径不在项目根目录下(比如直接拖进来的
/tmp/test.php或放在vendor/下的文件) - 文件刚新建但还没按
Ctrl+S保存过(未保存 = 无快照) - 当前焦点不在编辑器区域(例如 Terminal、Database 或 Project 工具窗口激活时,右键菜单不显示该选项)
- 该路径被
Settings → Editor → File Types → Ignore files and folders显式排除了
文件已从项目中彻底消失,怎么打开 Local History
不能右键一个不存在的文件,所以要换入口:
- 右键项目根目录(或任意空白处)→
Local History → Show History - 左侧时间线中找带
Deleted标记的条目,或滚动到删除操作前一刻的快照 - 右侧文件树里展开对应路径,定位到你删掉的
xxx.php或config.yaml - 双击预览内容确认是目标文件(看关键函数名、注释或结构是否匹配)
恢复时容易覆盖或丢内容的三个细节
Revert 看似一键解决,但实际是覆盖写入,必须留意:
立即学习“PHP免费学习笔记(深入)”;
- 如果当前目录下已有同名新文件(比如你重建了一个空
ApiService.php),Revert会直接把它替换成历史版本——建议先手动备份现有文件夹 - 双击历史记录里的文件只能预览,不能复制某几行;如只需恢复部分代码,应双击打开对比视图,再右键某段 →
Copy Lines from Left to Right - 默认保留 5 天,但如果你在 6 月 25 日删的文件,今天(7 月 1 日)可能已被自动清理;可提前去
Settings → Appearance & Behavior → System Settings → Local History把Keep local history for (days)改大
Local History 不依赖 Git,也不需要你 commit 过,但它只管“IDE 看得见”的文件——一旦路径被忽略、文件没保存、或 .idea/localHistory/ 被清空,就真没了。


















