local history 快照不显示或时间线空白是因 webstorm 无法加载 .idea/localhistory/ 数据，常见于手动删除 .idea、磁盘满、异常退出致索引损坏；需删 localhistory 子目录后重启重建，并调高保留天数、启用空闲自动保存。
Local History 快照不显示或时间线空白
不是没记录，而是 WebStorm 无法加载 .idea/localHistory/ 下的快照数据——常见于手动删过 .idea 目录、磁盘空间满导致写入中断，或 IDE 异常退出后索引损坏。此时右键 → Local History → Show History 会打开空窗口，或只显示“Loading…”后静默失败。
实操建议：
- 关闭 WebStorm（macOS 务必检查 Activity Monitor 中是否残留进程）
- 进项目根目录，执行
rm -rf .idea/localHistory/（仅删这个子目录，保留.idea/modules.xml等其他文件） - 重启 WebStorm，它会在首次保存或编辑后自动重建 localHistory 目录并开始新快照
- 若仍为空，检查
Settings → System Settings → Local History中「Save files automatically when application is idle」是否启用；未启用时，快照只在显式保存（Ctrl+S）后触发，容易漏
Revert 操作后文件内容没变或被覆盖错
Local History 的 Revert 是直接覆盖写入当前路径下的同名文件，不校验文件是否存在、是否被修改过。你看到“恢复成功”，但实际可能覆盖了刚改的新内容，或因编码问题导致乱码（比如原文件是 UTF-8 BOM，快照存的是无 BOM 版本）。
实操建议：
- 执行
Revert前，先手动复制一份当前文件备份（哪怕只是重命名加.bak） - 右键目标必须是**原父目录**，不是编辑器标签页——如果文件已删，就右键它原来所在的文件夹；如果文件还在但内容错，就右键该文件本身（快捷键
Alt+Shift+H更准） - 恢复后若显示乱码，别急着再 revert：右键文件 →
File Encoding→ 显式选 UTF-8 或对应编码，再重新打开 -
Revert不会触发 Git 状态变更，所以不会影响暂存区或工作区标记，但也不会自动git add，后续需手动处理
Local History 默认只保留 5 天，但你删文件是上周三
WebStorm 默认清理策略是「最近 5 天 + 最多 5000 个快照」，且快照不是按天均匀分布的——它依赖编辑/保存频率。如果你关机超过 24 小时、又没手动触发「Save all」，中间状态大概率已丢失，即使时间没超 5 天，也可能找不到想要的版本。
实操建议：
- 立刻进
Settings → System Settings → Local History，把Keep records for (days)调高到 14 或 30（大项目建议设 30） - 勾选
Save files automatically when application is idle，并设为 30 秒或更短，避免因忘记保存而断档 - 对关键文件（如配置、核心逻辑），养成
Ctrl+K提交前先 commit 的习惯——Local History 是兜底，Git 才是主力 - 别依赖「刚删完一定能找回来」，
Recent Changes（Alt+Shift+C）只缓存几分钟，过了就真没了
.idea/localHistory 权限错误或被杀毒软件锁定
Linux/macOS 上常见 Permission denied 导致快照写入失败；Windows 下某些杀软（如 360、火绒）会拦截 .idea/localHistory/ 的写操作，表现为快照生成延迟、部分文件缺失、甚至整个目录变成只读。
实操建议：
- 终端进
.idea/localHistory/，运行ls -la（macOS/Linux）或attrib（Windows），确认目录非只读、用户有读写权限 - 临时禁用杀毒软件实时防护，重启 WebStorm 后观察 Local History 是否恢复正常生成
- 若用 WSL2，确保
.idea在 Linux 子系统内（而非 Windows 挂载路径下），否则文件系统元数据不兼容会导致快照静默失败
