Sublime的代码折叠由syntax definition控制，非设置项开关；折叠粒度取决于.sublime-syntax文件中fold: true等规则定义，修改需编辑对应语法文件并保存至Packages/User/目录。
Sublime 的代码折叠级别由 syntax definition 控制，不是靠设置项开关
Sublime Text 本身不提供“折叠到第 N 层”的滑块或数字配置，fold_level 这类参数只在插件或 API 调用中出现，原生折叠行为完全取决于当前文件的 syntax definition（即 .sublime-syntax 文件）是否定义了 fold scope 和对应规则。
常见错误现象：Ctrl+Shift+[ 折叠后只收起函数，类名没折叠；或者 JSX 里 {} 块完全不响应折叠。
- 不同语言的折叠粒度差异极大：Python 靠缩进，JS 靠大括号，HTML 靠标签对，但都依赖 syntax 文件里是否写了
fold: true或foldable: true - 你改
Preferences.sublime-settings里的fold_buttons或fade_fold_buttons，只影响折叠按钮显示，不影响折叠逻辑 - 真正生效的是 syntax 文件中的
repository段落 —— 比如JavaScript.sublime-syntax里对meta.function和meta.block的 fold 定义
如何让某语言支持更细粒度的折叠（比如按 if/for 块）
得手动编辑或替换 syntax definition，不是改用户设置。Sublime 默认语法大多只对函数、类、顶层块做折叠，控制流语句（if、for、while）通常被归入更宽泛的 meta.block，没单独标记为可折叠。
- 先确认当前 syntax 名：打开命令面板（
Ctrl+Shift+P），运行View Package File，输入JavaScript查看JavaScript.sublime-syntax内容 - 搜索
fold:或foldable:，找到类似- match: \{.*?\}的规则，它决定哪些结构能折叠 - 想让
if块可折叠，需在repository中新增匹配if\s*\(.*?\)\s*\{的 pattern，并加上fold: true - 修改后保存到
Packages/User/JavaScript.sublime-syntax（优先级高于默认包），重启 Sublime 生效
折叠失效的三个高频原因和对应检查点
不是所有“看起来该折叠”的地方都能折，尤其在混合语法（如 Vue 单文件组件、Markdown 中嵌代码块）里容易断掉。
-
scope不匹配：用Ctrl+Shift+P→Developer: Show Scope Name点击目标行，看输出里有没有带meta.fold或meta.block—— 没有就说明 syntax 没定义折叠范围 - 嵌套过深：Sublime 默认最多折叠 10 层（硬编码限制），深层嵌套的 JSON 或模板字符串会自动停在某一层，无法继续向内折
- 语法切换失败：.vue 文件里
<script>块可能被识别为source.js，但实际加载的是Vue Component语法，导致折叠规则不生效；此时需确保View → Syntax → Vue Component被选中
用插件补足原生限制（仅推荐特定场景）
插件不是万能解药，多数折叠插件（如 CodeFold）只是模拟折叠视觉效果，并不改变 Sublime 的底层折叠机制，还可能和原生折叠冲突。
-
ExpandRegion插件适合临时扩大/缩小选择范围，但不改变折叠状态，不能替代 syntax 级控制 -
BracketHighlighter可高亮配对括号，辅助你手动判断哪里该折，但它本身不触发折叠 - 唯一较可靠的扩展是
ApplySyntax+ 自定义 syntax，用于给非标准后缀（如.conf、.env）注入折叠规则 —— 但前提是你得写清楚 scope 和 fold 条件
真正要稳定按层级折叠，绕不开 syntax definition 的细节。很多人卡在“以为改个设置就能解决”，其实得进 YAML 文件里一行行调 pattern 和 scope。
