被 git pull 或 git reset --hard 覆盖的未提交代码，只要文件曾被 PhpStorm 跟踪并保存过，Local History 就能找回；它不依赖 Git，只依据是否在项目根目录、是否保存过、是否被 IDE 排除来决定能否恢复。
直接说结论：被 git pull 或 git reset --hard 覆盖掉的本地未提交代码，只要文件曾被 PhpStorm 跟踪并保存过，Local History 就能找回——它不看 Git 状态，只认自己拍下的快照。
为什么 Git 操作后 Local History 还在，但右键菜单灰了
这不是功能失效，而是你当前操作的对象不对：
- 别在已被 Git 覆盖、内容全变的文件上右键——它可能已脱离 IDE 的监控路径（比如刚被
git checkout替换，IDE 还没重载） - 正确做法是：在 Project 工具窗口（
Alt+1）里，右键项目根目录 →Local History→Show History - 如果文件本身已从项目结构里消失（比如被
git clean -fd删了），也必须在父级目录（如src/或整个项目根）上右键，不能在空处或 Terminal 窗口里点
Local History 能找回哪些“Git 不认”的文件
它只关心三件事：是否在项目根目录下、是否至少保存过一次、是否没被 IDE 排除。所以这些情况它都能救：
- 新建的
utils.php写了一半，还没git add，就被git pull覆盖 —— 只要你按过Ctrl+S，快照就有 - 放在
app/Temp/下的调试脚本，没纳入 Git，但被git reset --hard连带清掉 —— 只要路径没进Settings → Editor → File Types → Ignore files and folders，就安全 -
vendor/里的修改？默认不行——该目录被 IDE 自动排除，除非你手动删掉vendor在忽略列表里的规则
恢复时怎么避免二次覆盖
Revert 是覆盖操作，而你刚被 Git 覆盖的文件很可能还开着、有未保存改动。务必先：
立即学习“PHP免费学习笔记（深入）”；
- 确认当前编辑器 tab 里文件状态：如果右上角有星号（*），说明还有未保存的脏数据，先
Ctrl+S或另存为备份 - 双击历史记录中的某条快照，在对比视图里预览内容——
Local History不显示文件内容缩略图，不点开看一眼，你不知道那是不是你要的版本 - 只想拿回几行？别点
Revert。在对比视图中，右键左侧（旧版）某段代码 →Copy Lines from Left to Right，粘贴到当前文件对应位置即可 - 如果恢复的是整个文件夹，
Revert会把该路径下所有快照中存在的文件都还原，不是单个文件粒度——小心误恢复其他人的临时测试文件
快照没了？检查这三处
不是所有“删了就找不回”都是真丢了：
-
.idea/localHistory/目录是否被手动清理过？这个路径下按项目结构存着二进制快照，删了就真没了 - 设置里是否关掉了功能？去
Settings → Version Control → Local History，确认Enable local history是勾选状态 - 保留天数是否太短？默认 5 天，如果你是上周五改的，今天才想起来找，大概率已被自动清理——调大
Keep local history for (days)是预防性刚需
真正容易被忽略的点是：Local History 快照生成时机不依赖 Git 操作，但依赖 IDE 的文件系统事件监听。如果文件被外部工具（如 rsync、mv 命令）直接替换，而 PhpStorm 没触发重载，那一瞬间的快照可能就断了。所以，对关键临时文件，手动 Ctrl+S 比等自动保存更可靠。
