Local History插件历史列表为空,是因为文件未保存(untitled)、修改后未保存就撤回、或路径不匹配;需确保已保存、路径一致且插件启用。

Sublime Text 本身不保存编辑历史记录,所谓“历史修改记录”只能靠插件实现,且必须满足“已保存文件 + 正确路径 + 插件已启用”三个条件,缺一不可。
Local History 插件为什么点开是空的?
不是插件没装好,而是它根本不会为以下情况生成快照:
- 文件从未执行过
save(仍是Untitled),且配置项backup_untitled为false(默认值) - 修改后只按了
Ctrl+Z撤回,但没再save—— 插件只在保存时刻触发备份 - 当前文件路径和插件记录的原始路径不一致(比如删掉后新建同名文件但位置不同,或用拖拽方式打开而非从项目树中打开)
确认是否生效:改一行 → Ctrl+S → 再改一行 → Ctrl+S → 右键 → Local History → Show History,这时应至少看到两条带时间戳的记录。
恢复已删除但曾保存过的文件
插件不依赖当前文件是否存在,只认路径。所以:
- 先在原位置新建一个同名空文件(确保完整路径一致,包括大小写和扩展名)
- 保存它(
Ctrl+S),让它被 Local History 插件“认领” - 右键 →
Local History → Show History,列表就会出现该路径的历史版本
注意:Restore 按钮会直接覆盖当前文件内容;如果只想比对,点击历史条目会在新标签页以只读方式打开,支持复制粘贴。
BackupOnSave 和 Simple History 有什么区别?
两者都靠保存动作触发,但行为逻辑不同:
-
BackupOnSave:每次save都生成一个独立的.bak或带时间戳的副本,存在你指定的目录里,适合手动归档或脚本扫描 -
Simple History:把历史版本存进 Sublime 的本地数据库(Local/目录下),不产生额外文件,右键菜单调用更轻量,但无法被外部工具直接读取 - 二者不兼容共存——同时启用可能导致重复备份或菜单冲突,建议只选其一
如果你需要 Git 那种可 diff、可批量清理的备份,BackupOnSave 更可控;如果只是偶尔回溯,Simple History 更省心。
为什么刚保存的内容没出现在历史里?
Local History 插件默认有 1 秒延迟写入,且受 Sublime 的异步 I/O 调度影响。常见干扰点:
- 文件正在被其他进程占用(如 Git 正在提交、杀毒软件扫描)→ 备份失败无提示
- 磁盘空间不足或
Local/目录权限受限 → 插件静默跳过备份 - 你启用了
hot_exit: true,而插件在退出瞬间来不及刷盘 → 建议设为false并正常退出
最稳妥的做法:改完关键段落后,手动按一次 Ctrl+S,稍等半秒再看历史菜单——别依赖“自动”二字。

















