Local History无法恢复被覆盖文件，因其仅监听IDE内操作（如编辑保存、Git集成变更），不捕获外部覆盖（如终端cp、拖拽替换），故快照缺失；需立即停写磁盘、查回收站、用testdisk等工具扫描恢复。
PhpStorm 的 Local History 无法恢复被覆盖的文件——它只记录“修改”和“删除”，不记录“覆盖写入”操作。如果你用新内容直接保存到一个已有文件（比如改了代码后 Ctrl+S），Local History 会保留该文件的历史版本；但如果是用外部命令、脚本、或拖拽替换（如把另一个 index.php 直接拖进项目覆盖原文件），PhpStorm 完全感知不到这个动作，也就不会生成快照。
为什么 Local History 看不到被覆盖的文件
Local History 是 PhpStorm 在后台自动对项目目录做增量快照的机制，依赖 IDE 对文件系统的监听。它能捕获：
- 你在编辑器里修改并保存的文件（
Ctrl+S或自动保存触发） - 在项目视图中右键执行的
Delete、Rename、Move - 通过 Git 操作（如
git checkout、git reset）引起的变更（前提是启用了 Git 集成监听）
但它不监听以下行为：
- 终端中执行
cp new.php old.php或mv替换 - 资源管理器/文件管理器中拖拽覆盖
- 其他编辑器（如 VS Code、vim）直接保存覆盖
- FTP/SFTP 工具上传覆盖
一旦发生这类覆盖，原文件的 inode 可能被直接复用，Local History 的快照目录（.idea/localHistory/）里没有对应时间点的备份，查也查不到。
立即学习“PHP免费学习笔记（深入）”；
确认 Local History 是否还有救
别急着关 IDE，先快速验证是否还存有可用快照：
- 右键点击被覆盖的文件 → 选择
Local History→Show History - 看弹出窗口里有没有早于覆盖时间的条目；注意时间显示是本地时区，不是 UTC
- 如果列表为空，或最新一条时间戳晚于你执行覆盖的时间，说明没记录，跳过这步
- 检查
.idea/localHistory/目录是否存在且非空：ls -la .idea/localHistory/；若该目录被手动删过、或磁盘损坏，快照已物理丢失
常见干扰项：Synchronize files on frame activation 和 Save files automatically when application is idle 这两个选项若未启用，会导致部分编辑未及时落盘，Local History 快照间隔拉长甚至缺失——不是 bug，是配置问题。
覆盖后还能做什么？优先级从高到低
覆盖 ≠ 绝对不可逆，但恢复窗口极短，操作顺序直接影响成功率：
- 立刻停止向该磁盘写入任何数据（不要保存新文件、不要安装软件、不要运行构建）
- 检查系统回收站（
~/.local/share/Trash/files/on CentOS）——有些文件管理器覆盖前会先把旧文件移入回收站 - 尝试系统级文件历史（如 Windows File History / macOS Time Machine），CentOS 默认不开启，但若你配过
rsync定时备份或borgbackup，现在就是用的时候 - 用专业恢复工具扫描磁盘：推荐
testdisk（命令行，免费）或PhotoRec（同源，专攻文件内容恢复），它们不依赖文件系统结构，而是按特征码扫描原始扇区；注意必须在另一块盘上运行，恢复目标也必须另存 - 最后才看 Git：如果该文件曾被
git add过，即使没 commit，也能用git fsck --lost-found找 dangling blob；但纯新文件从未纳入 Git，则 Git 无能为力
Local History 是 IDE 层的便利功能，不是数据保险柜。真正防覆盖，得靠外部备份策略+编辑器保存习惯——比如强制开启 Safe Write（Settings → System Settings → Use "safe write"），让 PhpStorm 总是先写临时文件再原子替换，至少能保住旧版副本。
