ctrl+k, ctrl+0 折叠异常源于语法作用域识别失效，需确认右下角语言标识、检查 fold_buttons 设置及语法插件兼容性，并用 fold_selection 临时折叠非代码块。
Ctrl+K, Ctrl+0 折叠全部但结果不对？先确认语法和作用域层级
这个命令调用的是 fold_all，但它不是“把所有缩进块都收起来”，而是按当前语言语法定义中声明的 scope depth 逐级折叠。比如在 Python 中，fold_all 默认只折到 meta.class 和 meta.function 层，不会动 if 或 for 块——除非它们被语法包识别为同级作用域。
常见误判场景：
- 右下角显示
Plain Text：整个折叠系统不启动，fold_all变成空操作 - 用了第三方语法插件（如
Python Improved）：它可能删掉了原生foldingStartMarker规则，导致fold_all找不到可折叠点 - 文件 >10MB：命令会延迟响应，状态栏短暂卡住，但不是失败
验证是否真生效：按 Ctrl+Shift+P → 输入 Developer: Show Scope Name，光标停在 def foo(): 行，看状态栏是否含 meta.function；不含就说明语法没加载或作用域未识别。
想折 JSON 配置段或日志块？别等语法支持，用 fold_selection
原生 fold_selection 是唯一绕过语法解析、缩进校验和 fold rules 的方式，适合临时整理非代码内容。
操作很简单：
- 鼠标拖选任意行（包括空行、注释、JSON 对象、base64 字符串）
- Windows/Linux 按
Ctrl+Shift+Alt+[，macOS 按Cmd+Ctrl+Option+[ - 侧边栏立刻出现独立三角图标，点击即可展开，不影响其他自动折叠块
注意两点：
- 该折叠仅存于当前会话，关文件即丢，不写入磁盘
- 不能和
fold_all混用：一旦手动折叠了某段，Ctrl+K, Ctrl+J（unfold_all）不会还原它，得单独点侧边栏箭头
// region 注释折叠失效？检查顶格与语法支持范围
Sublime 原生支持 // region / # region，但有两个硬性条件：
-
// region description必须顶格书写，前面不能有空格或 Tab，否则语法高亮引擎直接忽略整行 - 仅部分语言默认启用：JavaScript、TypeScript、C++、PHP 支持；Python 默认支持
# region，但需确保用的是官方Python语法（不是Python Improved或Python 3插件）
如果写了仍不生效：
- 按
Ctrl+Shift+P→Set Syntax: Python，强制切回原生语法 - 打开
Preferences → Settings，确认没有"fold_enable": false或"fold_buttons": false - 不要混用
// region和/* region */，后者不被原生识别
侧边栏折叠按钮消失？不是 UI bug，是设置被覆盖
即使快捷键能用，fold_buttons 关闭后侧边栏就不会显示三角图标，这会让手动折叠和区域定位变得极不方便。
必须检查用户设置（Preferences → Settings 右侧面板）中是否有：
-
"fold_buttons": true—— 这是开关，缺了或设为false就没图标 -
"fade_fold_buttons": false—— 否则鼠标不动时按钮会淡出，容易误以为没加载 - 插件写入的冲突项：比如旧版
Vue Syntax Highlighter会在用户设置里悄悄加"fold_enable": false，删掉即可
改完不用重启，但得切换一次标签页或重新加载语法（比如切到另一个文件再切回来），否则设置不热更新。
真正容易被忽略的点：折叠能力完全由语法定义驱动，而语法定义是否加载、是否含 foldingStartMarker，才是底层开关。多看一眼右下角的语言标识，比背十个组合键都管用。
