Sublime Text 侧边栏顶级文件夹顺序仅由 .sublime-project 文件中 folders 数组的顺序决定,拖拽或设置均需满足项目已保存、路径合法且写入成功等条件,手动编辑 JSON 是唯一可靠方式。

Sublime Text 里没有“项目排序规则”这个概念——项目本身不排序,你真正想控制的,是侧边栏中**顶级文件夹的显示顺序**,而它只由 .sublime-project 文件里的 folders 数组顺序决定,和任何“排序设置”无关。
为什么改了 sort_folders_first 没用?
这个设置只影响「单个文件夹内部」的子项排列:让子文件夹排在子文件前面。它对多个顶级文件夹(比如 core/ 和 docs/)谁在上、谁在下,完全没作用。
-
"sort_folders_first": true不会把core/推到docs/上面 -
"sort_files_by": "name"在 ST4.4158+ 才生效,且只在每个文件夹内部按名称重排子项 - ST3 用户写这行配置会被直接忽略,既不报错也不生效
拖拽重排为什么有时失效?
Sublime Text 4.4158+ 确实支持拖拽调整侧边栏顶级文件夹顺序,但前提是:
- 当前必须是已保存的项目(即存在有效的
.sublime-project文件),不是“单文件打开”或“临时文件夹”模式 -
folders数组不能为空,每个元素必须是含path键的合法对象(如{"path": "/abs/path"}) - 拖拽松手后 Sublime 必须成功重写该 JSON 文件——路径含中文、空格或权限不足时,常静默失败
- Windows/Linux 远程桌面环境下,显卡驱动可能拦截拖拽事件,导致动画流畅但实际没落盘
哪怕看到拖拽动画完成,也请立刻打开 Project → Edit Project 确认 folders 数组是否真实更新。没写入磁盘 = 没生效。
手动编辑 .sublime-project 是唯一可靠方式
这是 100% 稳定、跨版本、跨平台的方法:
- 菜单选择
Project → Edit Project,打开当前项目的 JSON 配置 - 确保
folders是数组,每个元素形如{"path": "/full/absolute/path/to/folder"} - 把你想置顶的文件夹对象移到数组最前面,例如:
{"folders": [ {"path":"/Users/you/work/core"}, {"path":"/Users/you/work/docs"} ] } - 保存文件,侧边栏立即刷新(无需重启,不依赖子目录是否展开)
- 绝对路径优先;相对路径(如
".")在某些场景下行为不稳定,尤其涉及符号链接或网络路径时
真正容易被忽略的点是:项目切换和文件夹排序是两套独立机制。你想让 frontend/ 和 backend/ 同时存在且顺序固定?必须分别保存为两个 .sublime-project,再通过 Ctrl+Alt+P 切换窗口——而不是往一个项目里 Add Folder。后者只会共享设置、混淆上下文,还破坏排序控制权。


















