Sublime代码折叠由语法识别、作用域层级和用户操作共同决定，无全局开关；侧边栏图标需满足可折叠结构起点、fold_buttons为true且未被覆盖才显示；折叠状态仅存于当前会话，可通过gutter图标、省略号及Unfold All命令验证。

Sublime 的代码折叠状态不是“全局开关”，而是由语法识别、作用域层级和用户操作共同决定的实时视图状态；没有统一面板查看所有折叠点，但可通过侧边栏图标、命令反馈和作用域检查三路验证。

侧边栏折叠图标为什么有时不显示

折叠图标（▶）只在满足全部条件时才渲染：当前行被识别为可折叠结构起点、fold_buttons 设为 true、且该行未被其他折叠逻辑覆盖。

• 检查用户设置中是否包含 "fold_buttons": true —— 缺失或拼错（如写成 fold_button）会导致图标彻底消失
• 若已启用但图标仍不出现，按 Ctrl+Shift+P → 输入 Developer: Show Scope Name，光标停在 def 行时，输出里必须含 meta.function 或 meta.block；只有 source.python 说明语法未命中作用域
• 某些插件（如旧版 Vue Syntax Highlighter）会重写 .sublime-syntax 文件，删掉 foldingStartMarker 规则，导致作用域存在但折叠点丢失

如何确认某段代码是否已被折叠

折叠状态不写入文件，仅存于当前编辑会话；无法靠文件内容判断，只能通过 UI 和命令反馈验证。

• 左侧 gutter 出现 ▶ 图标即表示该行是某个折叠块的起始位置，点击可展开
• 已折叠的代码行末尾会显示省略号 …（例如 def foo(): …），这是最直观的视觉提示
• 执行 Ctrl+K, Ctrl+J 后无变化？说明当前视图中没有被 Sublime 识别为可折叠的区域——不是快捷键失效，而是底层作用域未加载
• 用命令面板执行 Unfold All，如果命令不可见或执行后无反应，基本可判定语法识别失败

fold_by_level 和 fold_all 的状态差异在哪

二者触发的折叠范围和持久性完全不同：fold_all 是一次性的全量遍历，fold_by_level 则依赖作用域深度匹配，且后者结果可叠加。

• Ctrl+K, Ctrl+0（fold_all）：强制折叠所有当前语法定义中标记为可折叠的顶层结构，不管嵌套深浅；关闭文件再打开即全部展开
• fold_by_level 命令：只折叠作用域嵌套深度（scope level）等于指定数字的结构；例如 Python 中 def 常在 level 2，但装饰器跨行或 docstring 紧贴 def 行会导致其实际 level 变为 1 或 3，需实测
• 多次执行 fold_by_level 2 不会重复叠加，但 fold_by_level 2 + fold_by_level 3 会分别收起两层结构，形成嵌套折叠效果
• 两者均不影响手动创建的 fold_selection 折叠（即鼠标选中后按 Ctrl+Shift+Alt+[），后者独立存在、互不干扰

哪些操作会意外清除折叠状态

折叠状态看似稳定，但在几类常见操作下会静默丢失，且无提示。

• 切换语法类型：比如从右下角手动把 Python 改成 Plain Text 再切回，所有自动折叠点立即消失（fold_selection 保留）
• 保存文件并重载：若文件过大（>10MB）或语法包加载异常，Sublime 可能跳过折叠初始化，重开后所有 ▶ 图标不恢复
• 启用/禁用插件后重启：特别是 BracketHighlighter、Vue Component 等插件，可能劫持 Ctrl+K 前缀或覆盖语法定义，导致原 fold_all 命令绑定失效
• 混用 Tab 和空格缩进：Python/YAML 文件中缩进不一致会让语法解析器提前终止作用域推导，def 行失去 meta.function 标记，已折叠的块在刷新后自动展开

真正容易被忽略的是：折叠状态不跨会话持久化，也不受项目设置影响；每次打开文件都是一次全新解析。与其依赖记忆或猜测，不如养成习惯——光标停在 def 行时顺手按一下 Ctrl+Shift+P → Show Scope Name，一眼确认作用域是否就位。