Sublime Text 原生仅支持 save_on_focus_lost 实现安全自动保存;auto_save 等字段不存在,配置无效且可能干扰插件;启用需在 User Settings 中添加 "save_on_focus_lost": true,失焦窗口时保存,新建未命名或只读文件除外。

Sublime Text 没有真正的“实时存储”功能,所谓“实时”只是错觉;最安全、最稳定的选择是启用 save_on_focus_lost,它在你切出整个窗口时才保存一次——不是每秒写盘,但能防断电丢内容。
为什么不能用 auto_save 或 auto_save_interval
这些字段根本不存在于 Sublime Text 原生配置中。你在设置里写上 "auto_save": true 或 "auto_save_interval": 60,Sublime 完全无视,既不报错也不生效。网上大量教程照搬旧资料或混淆插件配置,导致你改了却没反应。
- Sublime 官方文档和源码中从未定义过
auto_save这个键名 - 加了这类无效配置,可能干扰 AutoSave 插件的逻辑判断(尤其当插件也读取同名字段时)
- 如果设置文件语法出错(比如少逗号、引号不闭合),整个用户配置会加载失败,
save_on_focus_lost也会失效
怎么正确开启原生自动保存(推荐绝大多数人用)
只做三件事:打开设置、加一行、保存。不需要插件、不改路径、不重启。
- 按
Ctrl + ,(Windows/Linux)或Cmd + ,(macOS)打开设置面板 - 确保你在编辑右侧「User Settings」(左侧是只读默认项)
- 在花括号
{}内添加:"save_on_focus_lost": true,注意前后逗号位置和英文双引号 - 按
Ctrl + S保存,立刻生效
验证方法:改几行字 → 点击桌面或终端 → 切回 Sublime → 文件已保存。注意:仅切换 tab 不触发,这是设计,不是 bug。
想“空闲就存”?必须关掉 save_on_focus_lost 再装 AutoSave 插件
AutoSave 插件和原生 save_on_focus_lost 同时开启,会导致同一文件被重复保存——对日志、大 SQL 文件或被外部进程轮询读取的文件,可能引发 I/O 冲突或数据错乱。
- 先在 User Settings 中删掉或注释掉
"save_on_focus_lost": true - 按
Ctrl + Shift + P→ 输入Package Control: Install Package→ 搜索安装AutoSave - 进入
Preferences → Package Settings → AutoSave → Settings – User,写入:
{
"auto_save_on_idle": true,
"auto_save_delay_milliseconds": 3000
}
注意:auto_save_delay_milliseconds 是唯一有效的延迟字段;auto_save_delay_in_ms、auto_save_delay_in_seconds 等写法在 v4.1+ 版本中已失效。设太小(如 500)会导致边打字边保存,UI 卡顿。
容易被忽略的关键细节
新建未命名文件(显示为 untitled)不会触发 save_on_focus_lost,这是硬限制——Sublime 不知道该存到哪;只读文件失焦时会弹错误提示,而不是静默跳过;插件保存后标签页仍显示星号(*),因为 Sublime 的“已保存”状态不会被插件修改重置。这些不是配置问题,是机制使然。











