ctrl+shift+[ 无效需先满足三前提:状态栏显示真实语言名、光标在可折叠结构起始行、语法定义含 foldingstartmarker;任一缺失即静默失败。

Ctrl+Shift+[ 没反应?先确认三个硬性前提
这个快捷键不是“按了就折”,它只在同时满足以下三点时才生效:右下角状态栏显示 Python、JavaScript 等真实语言名(不能是 Plain Text),光标停在可折叠结构的起始行(如 def、function、{、if 行),且当前语法定义中存在 foldingStartMarker 规则。任意一项缺失,操作都会静默失败。
验证是否识别成功:光标停在 def foo(): 行,按 Ctrl+Shift+P → 输入 Developer: Show Scope Name,若状态栏显示含 meta.function.python,说明函数作用域已识别;若只有 source.python,大概率是语法包未加载或被插件干扰。
- 混用
Tab和空格缩进会直接破坏 Python/YAML 的作用域解析链,导致def行无法进入meta.function作用域 —— 统一转为空格:View → Indentation → Convert Indentation to Spaces - 文件后缀异常(如
.pyi、.j2)会导致 Sublime 无法自动绑定语法,需手动点击右下角切换 - 某些插件(如旧版
BracketHighlighter)会劫持Ctrl+K前缀,临时禁用后重试可快速验证
Ctrl+K, Ctrl+0 折不全?别怪快捷键,怪语法识别
Ctrl+K, Ctrl+0 调用的是 fold_all 命令,它只折叠当前语法定义中已声明的可折叠结构。如果右下角是 Plain Text,或 def 行未被识别为 meta.function,它就会跳过整块 —— 不报错、不提示、不反馈,只是“没折”。
这不是快捷键失效,而是底层作用域缺失。大文件(>10MB)下还可能出现短暂卡顿,属正常现象,非崩溃。
- 必须分两步按:
Ctrl+K松开,再按Ctrl+0(数字零,非字母O) -
Ctrl+K, Ctrl+1不等于“只折函数”,它折叠所有level 1结构,Python 中可能是import或if __name__ == "__main__":,而非def - 想绕过语法限制强制收起?用
fold_selection:鼠标拖选任意行 →Ctrl+Shift+Alt+[(Windows/Linux)或Cmd+Ctrl+Option+[(macOS)
只想折函数?fold_by_level 是唯一可控路径
Sublime 没有原生 fold_all_functions 命令。fold_by_level 是目前最接近“按语义过滤”的方式,但它不认语言,只认当前语法文件里 meta.function 所在的实际嵌套深度。
实操必须从验证开始:先用 Ctrl+Shift+[ 成功折叠一个函数,确认它真被识别为函数块(而非缩进块),再调用命令面板执行 fold_by_level。数字得实测,输错无提示,静默失败。
- Python 文件通常从
2开始,JS/TS 常需3,但装饰器跨行(如@decorator单独一行)或docstring紧贴def行会导致识别断裂 —— 加空行可修复 - 嵌套函数(如
def outer(): def inner():)需额外执行一次fold_by_level 3 - 若
show_scope_name返回只有source.python,说明语法识别已中断,fold_by_level必然无效,此时应优先修复语法环境
任意几行都要收起来?fold_selection 是最后防线
这是唯一不依赖语法解析、不校验缩进、不读取 foldingStartMarker 的折叠方式。它只认你选中的行范围,JSON 配置、日志段落、base64 字符串、注释块,全部适用。
操作后侧边栏会出现独立三角图标,点击即可展开,不影响其他自动折叠块。但它仅存于当前会话,关闭文件即丢,不写入磁盘;Ctrl+K, Ctrl+J(unfold_all)也不会还原它,必须单独点开。
- 选中方式灵活:鼠标拖选、
Ctrl+L连续选行、正则Find All后批量选中均可 - 该折叠不会被任何语法设置影响,也不受
fold_buttons控制 —— 即使你关了折叠按钮,侧边栏仍会出现独立图标 - 真正容易被忽略的是:它和
fold_all类命令互不兼容,混用后展开逻辑割裂,调试时容易误判“哪块没展开”











