local history右键灰显因文件未建快照：路径被忽略、未保存或焦点不在编辑器；整行标红需开启inline diff；恢复几行应复制而非revert；快照密度低可调idle为1秒。
Local History 右键菜单灰显？先查这三件事
不是功能坏了，是 PhpStorm 根本没给这个文件建快照。常见原因有三个：文件路径被忽略、从未保存过、焦点不在编辑器。
检查 Settings → Editor → File Types → Ignore files and folders，确认路径没匹配上 node_modules/、vendor/ 或自定义规则；新建文件必须按 Ctrl+S（或启用自动保存）才生成首条快照；右键前确保光标在代码编辑区，而非 Terminal 或 Database 标签页。
快速验证：去项目根目录下看 .idea/localHistory/ 里是否存在对应子路径，比如 src/Service/User.php 应有 .idea/localHistory/src/Service/User.php/。没有就说明 IDE 从没接管过它。
对比窗口整行标红？必须开 inline diff
默认只做行级比对，哪怕只改一个变量名，整行都会变色。这不是 bug，是开关关着。
打开对比窗口后，点右上角齿轮图标 → 勾选 Highlight differences inside lines；或者直接按快捷键：Ctrl+Shift+Alt+D（Windows/Linux）或 Cmd+Shift+Option+D（macOS）。
注意：这个设置不跨会话记忆，每次新开 Diff 窗口都要重开一次。如果仍无效，检查两版本编码是否一致（比如一个带 BOM，一个不带），或换行符是否混用（\r\n vs \n）。
只想恢复某几行？别点 Revert
Revert 是覆盖式操作，会把整个当前文件替换成快照内容，把你之后做的其他修改全丢掉。
正确做法是：
- 双击历史列表中某个时间点，在新窗口打开对比视图
- 在左侧（旧版）或右侧（当前版）任意代码块上右键 →
Copy Lines from Left to Right（或反向） - 这样只粘贴你选中的那几行，不影响其余内容
如果目标行在多个快照间反复变动，建议先用 Ctrl+Z 撤销最近几次操作，再结合 Local History 找到最干净的中间态。
Local History 快照密度太低？调 idle 时间到 1 秒
默认合并高频小修改，改了 10 分钟可能只存一条记录。这不是采样不准，是空闲检测阈值太高。
进 Settings → Appearance & Behavior → System Settings → Local History，把 Save files automatically if application is idle for (sec) 设为 1。
同时确认 Keep local history for (days) 设为 30（尤其团队共用项目但没强制 Git 提交习惯时）；取消勾选 Exclude files from local history 下的 node_modules 等目录——如果你真要查刚炸掉的 package.json，它得在里面。
真正容易被忽略的是：.idea/localHistory/ 目录不可删除，删了就永久丢失所有快照；且该目录随编辑频率增长，大项目保留超 7 天会拖慢 PhpStorm 启动和右键响应。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
