Sublime Text 不按缩进自动折叠代码，只依据语法定义中的 fold_level 或 foldingStartMarker；所谓“缩进折叠”实为 fold_by_level 命令根据作用域层级（如 meta.function.python）触发，缩进仅为语言语义表现而非识别依据。
Sublime Text 不根据缩进自动折叠代码，所谓“按缩进折叠”是误解；它只响应语法定义中明确声明的 foldingStartMarker 和作用域层级（fold_level），缩进本身不触发折叠逻辑。
为什么缩进看起来能折叠？其实是 fold_by_level 在起作用
Python、YAML 等靠缩进的语言，其语法文件（如 Python.sublime-syntax）为 def、class、if 等结构设置了 fold_level: 1 或 2，而不是因为 Sublime “数空格”。fold_by_level 命令会查找这些带 fold_level 标记的作用域，并按数值分层折叠——缩进只是语言语义的呈现方式，不是 Sublime 的识别依据。
常见误判：
- 把
Ctrl+K, Ctrl+1折叠成功归因于“4个空格”，实际是meta.function被标记为fold_level: 1 - 在未定义
fold_level的自定义 DSL 文件里强行缩进，fold_by_level完全无效 -
fold_all按层级递进折叠，但第一级未必对应“顶层缩进”，而是语法定义中fold_level: 1的所有节点（可能包括 import 块或模块级注释）
fold_by_level 和 fold_all 的行为差异必须分清
fold_by_level 是命令面板调用的精准控制命令，指定数字即只折该 level 的结构；fold_all（Ctrl+K, Ctrl+0）是状态感知型操作：第一次执行 ≈ 折所有 fold_level: 1，再按一次才尝试 fold_level: 2，依此类推。它不接受参数，也不保证每次展开/折叠的粒度一致。
实操要点：
- 先手动用
Ctrl+Shift+[折一个def，再运行Developer: Show Scope Name，确认输出含fold_level: 2（Python 函数常为 2） - 在命令面板输入
Fold Level 2，而非依赖Ctrl+K, Ctrl+0猜层级 -
fold_all在大 JSON 或 HTML 中易卡顿，fold_by_level更稳定，但需提前知道目标结构的实际 level
想真按缩进层级收起代码？只有两种可靠路径
Sublime 原生不提供“按 N 个空格缩进就折叠”的机制。若你坚持用缩进作为折叠信号，只能走以下两条路：
- 启用
"fold_by_level": true设置（仅对部分语言有效），并确保语法文件支持：比如 Python 默认支持，但 YAML 原生包不带fold_level，需手动补到Packages/User/YAML.sublime-syntax - 用
fold_selection手动选中缩进一致的多行（如一组配置项），按Ctrl+Shift+[—— 这完全绕过语法解析，但折叠状态不持久，关文件即丢 - 避免改
.sublime-syntax文件中的fold_expression正则：容易误折字符串或注释，且 Sublime 4+ 后升级会覆盖自定义内容
最常被忽略的硬性前提：作用域必须被识别出来
哪怕语法文件写了 fold_level: 1，如果当前行没被赋予对应作用域，fold_by_level 就是哑火。验证方法只有一个：Ctrl+Shift+P → Developer: Show Scope Name，光标停在 def foo(): 行，输出里必须出现 meta.function.python。没有这个，一切折叠操作都只是在和空气交互。而作用域识别失败，90% 是右下角显示 Plain Text 或用了不兼容的第三方语法插件。
