Sublime Text侧边栏不自动刷新是因默认不监听文件系统变化;需手动执行refresh_folder_list命令或配置插件轮询同步,注意项目须先保存且排除规则可能隐藏文件。

侧边栏文件树不自动刷新的常见原因
Sublime Text 默认不会监听外部文件系统变化,比如你用命令行删了某个文件、Git 切换分支、或用其他编辑器保存了同目录下的文件,侧边栏里的文件树仍显示旧状态。这不是 Bug,而是设计选择——为了减少资源占用和避免误操作干扰。
refresh_folder_list 命令手动触发刷新
这是最直接有效的同步方式,适用于你明确知道外部已改动、只需立刻更新侧边栏的情况。
- 快捷键:
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入refresh folder list,回车执行 - 菜单路径:Project → Refresh Folders
- 注意:该命令只刷新当前项目中已添加的文件夹,不会扫描未加入项目的子目录
启用 folder_exclude_patterns 和 file_exclude_patterns 后可能影响感知
如果你在 Preferences → Settings – Project 或用户设置里配置了排除规则,即使文件被外部创建,只要匹配这些模式,它就不会出现在侧边栏中——看起来像“没刷新”,其实是被过滤掉了。
- 检查是否误配了类似
"*.tmp"、"node_modules"这类宽泛排除项 - 临时注释掉这些配置,执行一次
refresh_folder_list,看文件是否出现 - 排除规则对刷新行为无副作用,但会决定“刷新后能看到什么”
想自动同步?靠插件,但要小心性能
原生 Sublime 不支持实时文件系统监听。若真需要自动刷新,可安装插件如 AutoSetSyntax(附带轻量监听)或更专注的 SideBarEnhancements,但主流推荐是 FileSync 或 FolderSync —— 它们通过轮询(非 inotify/fsevents)实现,有延迟且增加磁盘 I/O。
- 安装后通常需重启 Sublime 才生效
- 默认轮询间隔多为 2–5 秒,频繁修改大目录时可能卡顿
- 不建议在含数万文件的项目根目录启用自动同步
{
"folder_sync_enabled": true,
"folder_sync_interval": 3000
}
侧边栏刷新本质是“重新读取磁盘目录结构”,不是重载编辑器缓存。真正容易忽略的是:**项目未保存时,Refresh Folders 可能不生效**——务必先确保项目已保存(Project → Save Project As…),否则 Sublime 会按临时会话逻辑处理路径。










