auto_reload 是唯一有效的自动重载配置,启用后外部修改文件会静默重载,但未保存内容将被直接覆盖;原子写入、WSL2 和部分构建工具会导致失效,侧边栏状态不随其刷新。

auto_reload 是唯一有效的开关,其他字段全是无效配置
Sublime Text 原生不监听文件磁盘变化,auto_reload 是唯一控制“自动重载外部修改内容”的配置项。网上常出现的 always_reload_on_change、watch_files 等字段,Sublime 官方根本不识别——加了也没用,还会干扰判断。
- 打开 Preferences → Settings – User(只改右侧用户配置)
- 添加一行:
"auto_reload": true - 保存即生效,无需重启 Sublime
这个设置只影响已打开的文件:当它在磁盘上被 Vim、git checkout、日志轮转脚本等外部程序修改后,Sublime 会静默重载新内容(前提是没未保存编辑)。
原子写入和 WSL2 是两大静默失效场景
你改了文件,也开了 auto_reload,但 Sublime 就是不更新?大概率是写入方式触发了系统级绕过监控的机制。
- Vim / Neovim 默认用原子写入(先写
file.tmp,再rename),inotify/fsevents 事件丢失,Sublime 收不到变更通知 - WSL2 中 inotify 监控存在已知限制,尤其对 Windows 挂载路径(如
/mnt/c/...),auto_reload常常完全失灵 - 某些构建工具(如 webpack watch、rsync --delete)也会跳过常规文件更新流程
验证方法:在终端执行 touch 文件名,看 Sublime 是否响应;若响应,说明是写入方式问题,不是配置问题。
开启 auto_reload 后,未保存编辑可能被直接覆盖
这是最危险却最容易被忽略的一点:auto_reload: true 不会弹窗、不会提示、不会保留你当前的修改——它会在检测到磁盘变更的瞬间,直接丢弃所有未保存内容。
- 务必同步确认
hot_exit为true(默认开启),否则崩溃后未保存内容彻底丢失 - 确保
remember_open_files为true(默认开启),防止重启后标签页全空 - 如果常编辑日志或临时生成文件,建议额外加
"atomic_save": false,避免 Sublime 自己保存时也触发原子写入干扰外部监控
换句话说:auto_reload 和「防丢稿」不是一回事,它只管加载新内容,不管你的光标停在哪、写了多少行。
侧边栏文件状态不会随 auto_reload 刷新
auto_reload 只刷新编辑区内容,不影响侧边栏(sidebar)中文件图标的视觉状态。比如你用 git 修改了一个文件,Sublime 编辑区内容更新了,但侧边栏仍显示灰色(未修改)图标。
- 侧边栏刷新需手动触发:
Ctrl+Shift+P→ 输入Refresh Folders回车 - 想看 Git 状态?得靠插件,比如
GitGutter(行号旁标记)或AYGIT(命令面板运行AYGIT: Show Status查列表) - 这些插件依赖项目根目录存在
.git文件夹,且必须用 Sublime 打开整个文件夹,而非单个文件
别指望 auto_reload 能让侧边栏“活”起来——它只管内容,不管元信息。


















