Sublime侧边栏不自动刷新是设计使然,仅靠refresh folders命令可同步增删文件,需先保存项目;Reload Project才能应用项目配置变更,二者均不监听文件系统事件。

侧边栏不刷新?不是文件没变,是 Sublime 根本没监听目录结构
Sublime 的 auto_reload 只负责编辑区内容自动重载(比如你用 Webpack 改了 JS,保存后 tab 里内容会更新),但它对文件增删、重命名、目录移动完全无感。删了一个 .py 文件,侧边栏还挂着它;新建一个 config.json,它也不会自动冒出来——这不是卡顿,是设计如此。
真正管侧边栏“刷新”的,只有两个动作:手动触发文件夹重载,或重载整个项目配置。前者只刷新视图,后者连 folders 列表、构建系统、插件行为都一起拉新。
Ctrl+Shift+P → refresh folders 是最快捷的侧边栏同步操作
这个命令只刷新当前项目中已注册的文件夹列表,不改设置、不重读 .sublime-project,适合日常小范围同步:
- 必须先有项目上下文:菜单
Project → Save Project As…存一个.sublime-project,否则该命令灰色不可用 - 快捷键流程:按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入refresh folders,回车 - 效果:新增/删除的文件和文件夹立刻在侧边栏体现,但被你手动拖出侧边栏的文件夹不会回来(那是 UI 状态,不存进项目文件)
- 注意:它不会重新扫描子目录权限或隐藏文件,如果某层目录突然变灰/不展开,大概率是系统级访问问题,不是 Sublime 没刷
Project → Reload Project 才能真正同步外部改动后的项目结构
当你改过 .sublime-project 里的 folders、settings 或 build_systems,或者外部脚本批量增删了项目目录,仅 refresh folders 不够——必须重载整个项目:
- 菜单路径:
Project → Reload Project,快捷键Ctrl+Alt+P(Win/Linux)或Cmd+Alt+P(macOS) - 它会重新解析磁盘上的
.sublime-project文件,刷新侧边栏结构、应用新设置、激活新构建系统 - 已打开的所有标签页、分屏视图、光标位置全部保留,不关 tab,也不清 undo 栈
- 如果菜单项显示为
Save Project As…,说明当前是临时项目(只靠Add Folder to Project加的),得先存一次项目文件,才能启用重载
别指望“自动”——Sublime 不监听文件系统事件
没有插件时,Sublime 启动后就不再主动轮询或监听 inotify/FSEvents。这意味着:
- 任何“自动刷新侧边栏”的需求,本质都要靠人点一下或写个外部脚本调用
subl --project /path/to/project.sublime-project - 想让新增文件立刻出现,可以配合插件如
AutoSetSyntax(监听文件创建事件并触发重载),但仍有延迟,且无法处理重命名冲突 - 批量重命名后,SideBarEnhancements 插件不会自动刷新侧边栏 —— 它改完文件就结束,你得自己按
Ctrl+Shift+P→refresh folders或切到其他 tab 再切回来触发一次视图重绘
最常被忽略的一点:侧边栏是否显示某个文件,取决于它是否属于当前项目的 folders 范围,而不是它是否被打开过。临时拖进来的单个文件,永远不会出现在侧边栏里,无论你怎么刷新。

















