sublime代码折叠失效的根本原因是光标位置、语法识别、作用域定义三者未对齐；需确保光标停在正确行（如python的def行）、语法为真实语言（非plain text）、缩进统一，并优先用ctrl+shift+[手动折叠验证meta.function是否命中。
Sublime 的代码折叠不能靠“背快捷键”实现，必须让光标位置、语法识别、作用域定义三者对齐；否则 Ctrl+Shift+[ 会静默失效，Ctrl+K, Ctrl+0 折不全，fold_by_level 输数字没反应——全是表面操作，根子在状态没对齐。
光标停在哪，决定能不能折
Ctrl+Shift+[ 不是“选中就折”，它只响应光标所在行的最内层可折叠结构起点。常见失效不是快捷键坏了，而是光标放错了地方：
- Python：必须停在
def或class行（含冒号和缩进），不能停在函数体内部、空行、注释行或字符串里 - JavaScript：得停在
function、const xxx = () => {或{所在行，停在}或变量赋值行无效 - 验证方法：按
Ctrl+Shift+P→ 输入Developer: Show Scope Name，状态栏若只显示source.python，说明meta.function没命中，折叠起点丢失
右下角显示 Plain Text？折叠直接关机
语法识别失败时，所有基于作用域的折叠逻辑全部失效——这不是 bug，是 Sublime 的设计前提。Plain Text 模式下，Ctrl+K, Ctrl+0 和 fold_by_level 都不会触发任何折叠行为：
- 点击右下角语言名，手动切换为
Python、JavaScript等真实语法名（不是Python Improved或自定义变体，除非它明确定义了meta.function） - 快捷切换：按
Ctrl+Shift+P→ 输入ssjs（Set Syntax: JavaScript）或sp（Set Syntax: Python）回车 - 混用 Tab 和 Space 缩进（尤其 Python 文件）会导致语法解析中断，函数作用域无法识别，表现为该折的没折
想只折函数？别碰 Ctrl+K, Ctrl+0
Ctrl+K, Ctrl+0 是按缩进层级全量折叠，会把顶层 if、__all__ = []、模块级注释块一起收走。真正可控的是 fold_by_level，但它认的是语法定义中 meta.function 实际嵌套深度，不是固定值：
- 先手动用
Ctrl+Shift+[折一个函数，确认它被识别为函数块（而非纯缩进块） - 按
Ctrl+Shift+P→ 输入fold_by_level→ 回车 → 依次试2、3、1（Python 文件通常从2开始，JS 常是3） - 装饰器跨行（如
@decorator换行写在def上方）或 docstring 紧贴def行（def f(): """doc"""; pass），会导致跳过整个块；加空行可修复
自动折叠失效时，用 fold_selection 最稳
当语法识别失败、插件冲突或处理 JSON/日志/配置段落等非标准结构时，fold_selection 是唯一不依赖语法定义的兜底方案：
- 选中目标行（鼠标拖选，或连续按
Ctrl+L选多行） - 按
Ctrl+Shift+[（Windows/Linux）或Cmd+Shift+[（macOS） - 折叠后左侧 gutter 出现三角图标，点击即可展开；该折叠仅保存在当前会话，关闭文件即丢失
- 注意：
unfold_all（Ctrl+K, Ctrl+J）默认不恢复fold_selection创建的折叠，需单独点击或重复执行unfold_all
最常被忽略的点：折叠状态不持久，且不同语法包对 meta.function 的嵌套层级定义可能不一致——同一个 Python 文件，在官方语法和某些社区语法包下，fold_by_level 2 可能一个折函数、一个折类。实测永远比查文档快。
