PhpStorm本地历史记录存于.idea/localHistory/文件夹，为时间戳命名的二进制快照；删除.idea即永久丢失，不依赖Git。
PhpStorm 本地历史记录存在哪
PhpStorm 的 Local History 不依赖 Git，是 IDE 自动维护的本地快照，存放在项目根目录下的 .idea/workspace.xml 同级路径中 —— 实际位置是 .idea/localHistory/ 文件夹，每个文件对应一个时间戳命名的二进制快照。你删掉整个 .idea 文件夹，历史就彻底没了，Git 也救不回来。
常见错误现象：右键 → Local History → Show History 点开一片空白，或者只显示最近几小时的记录 —— 很可能是因为 .idea/localHistory/ 被手动清理过、磁盘空间不足被自动裁剪，或启用了“同步到远程服务器”导致本地快照被跳过。
- 默认保留 5 天内的变更（可调，见下一条）
- 每文件每次编辑触发快照，但连续快速输入（如打字）会被合并成一次，不是每敲一个字都存
- 重命名、移动、删除文件也会被记录，但仅限 PhpStorm 内操作；直接在资源管理器里删，IDE 可能只记“文件丢失”，不记内容
怎么调大 Local History 保存天数和快照密度
PhpStorm 默认只保留 5 天快照，且对高频修改（比如写 CSS 时反复改 margin）会自动降频采样，容易错过关键中间态。调整入口在 Settings → Appearance & Behavior → System Settings → Local History。
-
Keep local history for (days)：建议设为30，尤其团队共用项目但没强制 Git 提交习惯时 -
Save files automatically if application is idle for (sec)：设为1秒，避免切窗口后修改丢失 - 取消勾选
Exclude files from local history下的node_modules等 —— 如果你真要查某个被覆盖的package.json修改，它得在里面
改完不用重启，但旧快照不会回溯补全，只影响后续记录。
立即学习“PHP免费学习笔记（深入）”；
右键菜单里“Show History”没反应或报错 Cannot load history for file
这不是网络问题，也不是权限问题，而是 PhpStorm 找不到该文件对应的快照元数据。典型场景：文件刚被 Git 恢复（git checkout）、从其他项目复制进来、或通过 Find in Path 结果双击打开的临时视图。
- 确认文件真实路径在当前项目内 —— 把文件拖进项目窗格再试一次右键
- 检查
.idea/localHistory/下是否有对应路径的子目录（如src/utils/helper.js对应.idea/localHistory/src/utils/helper.js/），没有就说明从未被 IDE “接管”过 - 遇到
Cannot load history for file，别点“OK”关掉，先点Copy Stack Trace，搜日志里是否含history is disabled for—— 那说明该文件类型被规则排除了（比如你加过*.log到忽略列表）
对比两个历史版本时 diff 显示乱码或内容不对
Local History 的 diff 用的是 PhpStorm 内置比对器，不走系统编码设置。如果文件本身是 GBK 编码（比如老 Windows 项目里的 PHP 文件），而 IDE 默认按 UTF-8 解析快照，就会出现中文变问号、符号错位。
- 右键历史条目 →
Open in Editor，看右下角状态栏显示的编码 —— 如果是UTF-8但文件实际是GBK，点击切换并Reload as - 更稳妥的做法：在
Settings → Editor → File Encodings中，把Global Encoding和Project Encoding都设为System Default（Windows 就是 GBK），再清空.idea/localHistory/重来（已有快照编码已固化，无法修复） - diff 里显示“no content”？大概率是快照损坏，删掉对应文件路径下的整个时间戳子目录即可，下次修改会重建
Local History 是个安静的备胎，不声不响存着，但一旦出问题，往往卡在编码、路径、权限这三个最朴素的环节上 —— 它不挑 Git，但很挑你有没有把它当本地文件一样对待。
