sublime text代码折叠需语法识别、作用域定义和光标位置三者同时满足；ctrl+shift+[无效主因是光标不在可折叠结构首行或状态栏显示plain text而非真实语言名。
Sublime Text 的代码折叠不是“打开就自动生效”的功能，它严格依赖语法识别、作用域定义和光标位置三者同时满足；按 Ctrl+Shift+[ 没反应，90% 是因为光标不在可折叠结构首行，或右下角显示的是 Plain Text 而非真实语言名。
为什么 Ctrl+Shift+[ 折不了？先看光标和语法
这个快捷键只对光标所在行的**最内层可折叠结构起点**生效，不是“选中就折”，也不是“任意位置都能触发”：
- 光标必须停在
def、class、if（带冒号和缩进块）、function、{所在行——这些行左侧 gutter 才会出现 ▶ 图标 - 光标停在函数体内部某行（比如
print("x")），或空行、注释行、字符串里，Ctrl+Shift+[会静默失败 - 右下角状态栏必须显示
Python、JavaScript等真实语言名；若显示Plain Text，所有语法级折叠逻辑直接关闭 - 验证作用域是否被识别：光标停在
def行，按Ctrl+Shift+P→ 输入Developer: Show Scope Name，状态栏若只显示source.python，说明meta.function未命中，折叠起点丢失
Ctrl+K, Ctrl+0 和 Ctrl+K, Ctrl+1 到底折什么？
它们不按语义（如“函数”“类”）折叠，而是按语法定义中的 **作用域嵌套深度（scope level）** 执行：
-
Ctrl+K, Ctrl+0：调用fold_all，遍历当前视图所有已识别的折叠点，无视层级——但前提是文件已被正确识别为对应语言 -
Ctrl+K, Ctrl+1：只折叠 scope depth = 1 的结构，Python 中通常是顶层def和class，JS 中可能是function声明或模块级{块 -
Ctrl+K, Ctrl+2：再往里一层，比如函数体内的for、if、with块——但若某函数只有单行return，无更深嵌套，则不会被影响 - 注意操作顺序：先按住
Ctrl+K松开，再按数字键（如0），不是三键同时按；输错数字不会提示，只是没反应
想只折函数，不碰 if/class？用 fold_by_level 实测
Sublime 没有原生“仅函数”命令，Ctrl+K, Ctrl+0 会把顶层 if、class、__all__ = [] 全收走。真正可控的是 fold_by_level，但它认的是语法定义中 meta.function 所在的实际嵌套层级，不是固定值：
- 先确认一个
def行能被Ctrl+Shift+[正常折叠（否则fold_by_level无效） -
Ctrl+Shift+P→ 输入fold_by_level→ 回车 → 依次试2、3、1（Python 文件通常从2开始） - 装饰器跨行（如
@decorator换行写在def上方）或 docstring 紧贴def行（def f(): """doc"""; pass），会导致跳过整个块，加空行可修复 - 嵌套函数（
def outer(): def inner():）属于更深一层，可能需额外执行一次fold_by_level 3
语法失效时怎么临时收起大段代码？手动选区最稳
当文件是 .log、.txt，或右下角显示 Plain Text，又或者你想临时藏一段 JSON 配置、测试数据、日志片段——不用改配置、不装插件，fold_selection 是唯一零门槛方案：
- 鼠标拖选或多行选中（
Ctrl+L连续选行） - Windows/Linux 按
Ctrl+Shift+Alt+[，macOS 按Cmd+Ctrl+Option+[ - 左侧 gutter 出现独立三角图标，点击即展开，不影响其他自动折叠块
- 该折叠仅存于当前会话，关闭文件即消失；它不读
fold_comments，也不依赖任何语法定义
真正卡住人的，从来不是快捷键记不住，而是没意识到：折叠能力完全由语法定义驱动，而语法定义是否加载、是否含 foldingStartMarker、作用域是否被正确解析，才是底层开关。多看一眼右下角的语言标识，比背十个组合键都管用。
