local history 是 phpstorm 的键盘操作“回放录像”，能细粒度还原误删、误改等内容，但需文件被真实跟踪、保存且快照未清理；其非 git diff 替代品，也不跨机器或同步 git。

Local History 的对比功能不是 Git diff 的替代品，而是你键盘操作的“回放录像”——它能比 Git 更细粒度地还原删错的一行、改崩的正则、手抖覆盖的 JSON 字段，但前提是文件得被 PhpStorm 真实跟踪过、保存过、且快照还没被清理。

右键 Show History 点不开或空白？先确认这三件事

常见错误现象：Show History 菜单项灰掉、点开后列表为空、或只显示最近 2 小时记录。

• 检查文件是否在项目根目录下，且路径没被 Settings → Editor → File Types → Ignore files and folders 匹配（比如 node_modules/、vendor/ 默认被排除）
• 确认文件已至少保存过一次 —— 新建未保存的临时文件不会生成任何本地历史快照
• 进 .idea/localHistory/ 目录，看是否存在对应子路径（如 src/api/client.js 应有 .idea/localHistory/src/api/client.js/），没有就说明 IDE 从未对该文件建立过快照

对比窗口里整行标红？必须手动开 inline diff

默认只做行级差异（line diff），哪怕你只改了一个字符，整行都会变色。这不是 bug，是开关没打开。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 进入对比窗口后，点右上角齿轮图标 → 勾选 Highlight differences inside lines
• 或者直接按快捷键：Ctrl+Shift+Alt+D（Windows/Linux）或 Cmd+Shift+Option+D（macOS）
• 注意：这个设置不跨会话记忆，每次打开新对比窗口都要重新开一次

想还原某几行而不是整个文件？别点 Revert

Revert 是覆盖式操作，会把当前文件全部替换成快照内容，丢失你之后做的其他修改。

• 双击历史列表中某个时间点，在新窗口打开对比视图
• 在左侧（旧版）或右侧（当前版）任意代码块上右键 → Copy Lines from Left to Right（或反向）
• 这样只粘贴你选中的那几行，不影响其余内容
• 如果目标行在多个快照间反复变动，建议先用 Ctrl+Z 撤销最近几次操作，再结合 Local History 找到最干净的中间态

为什么改了 10 分钟，历史里只有一条记录？

Local History 不是每敲一个字都存，它会合并高频小修改。但这个“合并策略”可以调。

• 进 Settings → Appearance & Behavior → System Settings → Local History
• 把 Save files automatically if application is idle for (sec) 设为 1，避免切窗口后修改丢失
• 取消勾选 Exclude files from local history 下的 node_modules 等目录 —— 如果你真要查刚炸掉的 package.json，它得在里面
• 注意：调大保留天数（如设为 30）只影响后续快照，不会补全过去已丢的记录

Local History 快照存在 .idea/localHistory/ 下，二进制格式，删掉 .idea 就彻底清零；升级 PhpStorm 也会清空；它不跨机器、不上传、不和 Git 同步 —— 这些不是缺陷，是设计前提。依赖它救急可以，但别把它当 Git 用。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！