侧边栏顶级文件夹顺序唯一由.sublime-project中folders数组元素顺序决定:需手动编辑JSON,确保每个元素为含绝对path键的对象,置顶文件夹移至数组首位;拖拽仅在ST4.4158+且项目已保存、folders有效、写入成功时临时生效;sort_folders_first和sort_files_by均不改变顶级顺序。

侧边栏顶级文件夹的顺序完全由 .sublime-project 文件中 folders 数组的元素顺序决定——不是拖拽、不是设置开关、不是插件,只有这个数组顺序生效且持久。
为什么拖拽有时能改顺序,有时不行?
Sublime Text 4.4158+ 支持拖拽重排顶级文件夹,但前提是:
- 项目已保存为
.sublime-project文件(即不是“单文件打开”模式) -
folders数组非空、非null,且每个元素是含path键的有效对象 - 操作系统和显卡驱动未拦截拖拽事件(Windows/Linux 远程桌面下常见失效)
- 拖拽松手后 Sublime 必须成功重写项目文件——若路径含中文或特殊字符,偶尔会写入失败或乱序
哪怕你看到拖拽动画流畅,也建议立刻打开 .sublime-project 确认 folders 数组是否真实更新。没落盘=没生效。
如何手动编辑 .sublime-project 控制顺序?
这是唯一 100% 可靠的方式:
- 菜单选择
Project → Edit Project,打开当前项目的 JSON 配置 - 确保
folders是一个数组,每个元素形如{"path": "/your/path"} - 把你想置顶的文件夹对象移到数组最前面,例如:
{ "folders": [ {"path":"/Users/you/work/core"}, {"path":"/Users/you/work/docs"} ] } - 保存文件,侧边栏立即按新顺序刷新(无需重启、不依赖子目录是否展开)
注意:path 值必须是绝对路径;相对路径(如 ".")在某些场景下行为不稳定,建议显式写出完整路径。
sort_folders_first 和 sort_files_by 不影响文件夹之间顺序
这两个设置常被误用:
-
"sort_folders_first": true只控制「单个文件夹内部」:让该文件夹下的子文件夹排在文件前面(如src/components/显示在src/index.js上方),对多个顶级文件夹的上下位置毫无影响 -
"sort_files_by": "name"(ST4.4158+)只对「同一层级的文件和文件夹」做名称排序,但它不改变folders数组定义的顶层顺序——它只是在每个文件夹内部重新排列其子项 - ST3 用户写
"sort_files_by": "name"完全无效,解析器直接忽略,不会报错也不会排序
想让 core/ 永远在 docs/ 上面?别调这些设置,去改 folders 数组。
ST3 用户没有 sort_files_by,但还有别的路
如果你卡在 ST3,又需要名称排序:
- 安装
SideBarEnhancements插件(Package Control 可装) - 右键侧边栏空白处 →
Sort By → Name (A-Z),即时生效 - 注意:这是临时排序,关闭再打开项目就恢复原始顺序;它也不修改磁盘或项目配置
- 无法解决大小写敏感问题(
README.md仍排在api.py前面),也不支持自然排序(10.txt仍在2.txt前)
真正稳定可控的排序,始终绑定在 .sublime-project 的 folders 数组上——哪怕你用插件或拖拽,最终也得靠它兜底。别跳过这一步。










