侧边栏顶级文件夹顺序唯一由.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 数组上——哪怕你用插件或拖拽，最终也得靠它兜底。别跳过这一步。
