Sublime Text 4.4158+才支持sort_files_by，旧版需用SideBarEnhancements插件实现名称排序；排序受大小写、数字字符串及符号链接影响，文件夹顺序由.sublime-project中folders数组决定。
Sublime侧边栏文件名排序无效？先确认版本和配置项是否匹配
Sublime Text 4.4158+ 才支持 sort_files_by，旧版（如 ST3）写进去完全被忽略——不是失效，是压根不认。很多人改完设置没反应，第一反应是“配置错了”，其实是版本卡在了门槛外。
- 检查版本：菜单 Help → About Sublime Text，确认 Build 号 ≥ 4158
- 正确写法只有一行：
"sort_files_by": "name"，必须放在Preferences → Settings – User的 JSON 右侧区域 - 别混用旧参数：
sort_folder_files_alphabetically是 ST3 时代的兼容方案，ST4 中它仍可用但优先级低于sort_files_by，两者共存时以sort_files_by为准 - 改完不用重启，但若没刷新，右键侧边栏 → Refresh Folder 即可强制重载
ST3 用户怎么让文件按 A-Z 排？用插件补原生缺失能力
ST3 没有 sort_files_by，也没自然排序、忽略大小写等选项，纯靠配置无法实现真正意义上的名称排序。唯一靠谱路径是装 SideBarEnhancements 插件，它把排序变成右键动作，即点即排。
- 安装：Ctrl+Shift+P → 输入
Package Control: Install Package→ 搜SideBarEnhancements安装 - 使用：右键侧边栏任意空白处 → Sort By → Name (A-Z)，立刻重排（注意：仅当前会话有效）
- 限制很实在：排序结果不会写回项目文件，关掉再打开就回到原始顺序；它也不改变磁盘上文件的排列，只是视觉重绘
- 别指望它解决大小写混乱问题：比如
README.md仍会排在api.py前面（ASCII 序），插件本身不提供 ignore-case 选项
为什么文件看着没排序？常见干扰因素比配置错误更频繁
即使 sort_files_by 已启用且版本达标，你看到的“乱序”大概率不是 Sublime 的 bug，而是排序逻辑和现实命名习惯之间的错位。
- 大小写敏感：默认按字节值排序，
Zoo排在apple前面——这不是 bug，是设计。没有原生开关关闭它 - 数字字符串排序：
10.txt一定在2.txt前面，因为比较的是"10"和"2"的首字符'1'vs'2'。Sublime 原生不支持自然排序（natural sort） - 符号链接干扰：如果侧边栏里显示的是软链接，而链接目标路径与源路径结构不同，排序依据仍是链接本身的文件名，不是目标内容
- 未保存标签页不参与：你正在编辑但尚未保存的文件（tab 名带 * 号）根本不出现在侧边栏中，自然也不会被排序逻辑覆盖
想让文件夹永远置顶？靠项目文件手动定序，不是靠排序参数
sort_files_by 管文件，不管文件夹顺序。侧边栏顶部那些文件夹的排列，只由 .sublime-project 文件中 folders 数组的顺序决定——谁写在前面，谁就显示在上面。
- 操作路径：菜单 Project → Edit Project，调整 JSON 中
folders列表项的顺序，保存后立即生效 - 支持拖拽：在侧边栏里直接鼠标左键按住文件夹拖动，Sublime 会自动更新项目文件，比手写 JSON 更快
- 别依赖“文件夹优先”参数：
sort_folders_first只控制同一层级下文件夹和文件的相对位置（比如src/和README.md谁在前），不改变多个顶级文件夹之间的上下关系 - 单靠排序参数无法解决结构混乱问题：如果项目里混着
docs、src、tests三个平级目录，又希望src永远第一，就得把它固定在folders数组首位
最常被忽略的一点：排序逻辑本身极简，但它的效果高度依赖你的文件命名习惯和项目组织方式。与其花时间调参数对抗 ASCII 序，不如统一用 01_init.py、02_main.py 这类前缀，或者直接接受 Sublime 的排序规则，把精力留给真正影响开发效率的地方。
