Local History与Git的根本区别在于：前者是IDE自动维护的本地快照，记录文件每次保存、重构等操作后的状态，不依赖版本控制；后者仅在git commit后存档，管理已提交的版本历史。
Local History 不是 Git，但它能救你命——尤其当你没 commit、没 push、甚至没开 Git 的时候。
Local History 和 Git 的根本区别在哪
Local History 是 PhpStorm 自动维护的本地快照，不依赖任何版本控制系统。它每分钟、每次文件保存、每次重构或编辑操作后都会默默记录一次状态。Git 则只在你 git add 和 git commit 后才存档。这意味着：
- 即使你刚新建项目、还没初始化 Git，Local History 已经在工作
- 它不会记录你删掉整个文件夹后的“空状态”，但会保留删除前最后几版内容
- 它不跨机器同步，所有历史只存在你当前电脑的
.idea/workspace.xml和缓存目录里 - 默认保留 5 天内的修改（可调），而 Git 历史只要仓库还在就永远在
怎么快速打开并筛选修改记录
右键点击项目根目录或任意文件/文件夹 → Local History | Show History。别点错成 Git | Show History——后者只显示 Git 提交日志。
打开后你会看到带时间戳的列表，左侧是变更类型图标（+ 新增、- 删除、→ 重命名、✎ 修改）。常用筛选方式：
立即学习“PHP免费学习笔记（深入）”；
- 按住
Ctrl（Windows/Linux）或Cmd（macOS）多选多个时间点，右键 →Compare with…查看差异 - 双击某条记录，直接在编辑器中打开该时刻的只读快照（不能编辑，但可复制内容）
- 右键某条记录 →
Revert，把当前文件恢复到那一刻的状态（慎用，不可撤销） - 如果想查某段代码是什么时候被删的，先在编辑器里
Ctrl+F搜关键词，再打开 Local History 看哪次变更里还包含它
为什么有时看不到想要的修改记录
Local History 不是万能的，几个常见断档原因：
- PhpStorm 被强制退出（如 kill 进程），最后一次自动保存可能丢失
- 你手动清空了
.idea/shelf/或.idea/localHistory/目录（某些清理脚本会干这事） - 在设置里关掉了自动记录：
File | Settings | Appearance & Behavior | System Settings→ 取消勾选Save files on frame deactivation和Save files automatically if application is idle for … sec，会导致快照变稀疏 - 对大文件（>10MB）或二进制文件（如图片、zip），Local History 默认不跟踪内容，只记文件存在与否
补救办法：改回设置后重启 IDE，新修改就能被正常捕获；旧丢失的记录无法恢复。
对比两个时间点时容易忽略的细节
当你右键两条记录 → Compare revisions，IDE 会打开差异视图。这里的关键点：
- 左边是“旧”版本，右边是“新”版本——和 Git diff 正好相反（Git 是
old..new，显示 new 相对于 old 的变化） - 如果某行在左边为空、右边有内容，代表那是“新增”；反之则是“删除”
- 差异视图里点右上角
↓图标可导出为 HTML，方便发给同事确认改动 - 不要依赖它来还原整个项目结构——它只管文件内容，不记录目录移动、权限变更等元信息
Local History 最强的场景，永远是“我 3 分钟前删掉的那段正则，现在想粘回来”——而不是替代 Git 流程。
