Sublime代码折叠依赖语法识别、作用域标记和命令匹配：光标须停在可折叠结构起始行（如Python的def行），状态栏需显示正确语言名，混用缩进或装饰器跨行会导致失效；fold_selection可强制折叠任意选中行。
Sublime 的代码折叠不是“按缩进就能折”的功能，它完全依赖语法识别是否成功、作用域是否被正确标记、以及你用的命令是否匹配当前结构的实际嵌套层级。光标停错位置、右下角显示 Plain Text、装饰器跨行、缩进混用——任何一个都会让 Ctrl+Shift+[ 静默失效。
为什么 Ctrl+Shift+[ 按了没反应？
这个快捷键只对「可折叠结构的起始行」生效，不是任意位置都能触发：
- Python 中必须停在
def或class行；停在函数体内部、空行、注释行、docstring 行，命令不执行 - JavaScript 中要停在
function、const xxx = () => {或if (cond) {行；不能停在}或缩进块中间 - 右下角状态栏必须显示
Python、JavaScript等真实语言名，若为Plain Text，所有语法级折叠逻辑直接关闭 - 验证是否识别成功：光标停在
def行，按Ctrl+Shift+P→ 输入Developer: Show Scope Name，状态栏应含meta.function.python
Ctrl+K, Ctrl+0 折不全？检查这三件事
它调用的是 fold_all，但只折叠已被语法定义标记为可折叠的结构，不是“所有看起来像代码块的东西”：
- 必须分步按键：先按
Ctrl+K松开，再按Ctrl+0（数字零，不是字母 O） - 文件超过 10MB 时，响应可能延迟或卡在状态栏，属正常现象
- Python 文件混用 Tab 和 Space 缩进，会导致
def行未被识别为函数作用域，从而跳过折叠 - 插件如
BracketHighlighter可能劫持Ctrl+K前缀，临时禁用插件后重试可验证
只想折函数？别信 Ctrl+K, Ctrl+2，试试 fold_by_level
Ctrl+K, Ctrl+2 折的是作用域嵌套深度为 2 的结构，不是“所有函数”，Python 中它可能只收 import 或 if __name__ == "__main__":，而漏掉 def：
- 先确认一个
def行能被Ctrl+Shift+[正常折叠（否则fold_by_level必然无效） - 按
Ctrl+Shift+P→ 输入fold_by_level→ 回车 → 依次试2、3、1（Python 多数情况从 2 开始） - 装饰器跨行（如
@decorator单独一行紧贴def）或 docstring 紧贴def行，会导致识别断裂，加空行可修复 - 嵌套函数（如
def outer(): def inner():）需额外执行一次fold_by_level 3
任意几行都要收起来？fold_selection 是唯一 100% 可控方式
它绕过语法解析、缩进校验和折叠规则，适合紧急整理或语法失效场景：
- 鼠标拖选任意连续多行（JSON 配置、日志段、base64 字符串都行）
- Windows/Linux 按
Ctrl+Shift+Alt+[，macOS 按Cmd+Ctrl+Option+[ - 左侧 gutter 出现独立三角图标，点击即可展开/收起，不影响其他自动折叠块
- 该折叠仅存于当前会话，关闭文件即丢；
Ctrl+K, Ctrl+J（unfold_all）不会还原它，得单独点开
最易被忽略的点是：折叠按钮（gutter 里的 ▶）默认开启，但 UI 层可能被关掉。打开 Preferences → Settings，右侧用户设置中必须有 "fold_buttons": true，否则即使所有逻辑都对，你也看不到可点的图标。
