Sublime折叠class依赖meta.class作用域识别,需验证作用域名称、确保语言语法正确、避免装饰器紧贴和缩进混用;fold_by_level按嵌套深度折叠,fold_selection可手动选中折叠;折叠后无图标需检查fold_buttons设置。

Ctrl+Shift+[ 没反应?先确认 class 行是否被识别为可折叠起点
Sublime 折叠 class 不是靠关键词匹配,而是依赖语法高亮器输出的 meta.class 作用域。光标停在 class Foo: 这一行却按 Ctrl+Shift+[ 没反应,大概率是作用域没命中。
验证方法:光标放在 class 行,按 Ctrl+Shift+P → 输入 Developer: Show Scope Name 回车,看状态栏是否含 meta.class.python(Python)或 meta.class.js(JS)。如果只有 source.python,说明语法定义未触发 class 作用域,折叠逻辑直接跳过。
- 右下角必须显示
Python、JavaScript等真实语言名,不能是Plain Text - 类定义前若紧贴装饰器且无空行(如
@dataclass\nclass Foo:),部分语法包会把class行识别为meta.decorator子作用域,导致meta.class断裂 - 缩进混用(Tab + Space)会让 Python 解析器丢掉整个
class作用域,统一转为空格:View → Indentation → Convert Indentation to Spaces
fold_by_level 折 class 为什么有时连 if 一起折了?
Ctrl+K, Ctrl+N 折的是作用域嵌套深度(scope level),不是“所有 class”。Python 中 class 和顶层 if __name__ == "__main__": 常同属 level 1,所以 Ctrl+K, Ctrl+1 会把两者都收起——这不是 bug,是语法定义决定的。
- 想只折
class而留def和import,得先确认它们在当前语法中的实际 level:手动用Ctrl+Shift+[折一个class,再试Ctrl+K, Ctrl+2;若没反应,说明它在 level 1 - 输错数字(如
Ctrl+K, Ctrl+9)不报错,只是静默失败;建议从 1 开始试到 3 - JS/TS 中
class常和function同属 level 3,Ctrl+K, Ctrl+3才可能精准命中
想只折 class,其他结构不动?用 fold_selection 最稳
当 class 作用域识别不稳定,或你只想临时藏起某几个类(比如测试用的 class MockFoo:),fold_selection 是唯一绕过语法解析的方案。
- 鼠标拖选整个
class定义(从class行到对应缩进块末尾,含 docstring 和方法体) - Windows/Linux 按
Ctrl+Shift+Alt+[,macOS 按Cmd+Ctrl+Option+[ - 左侧 gutter 出现独立三角图标,点击即可展开/收起,不影响其他自动折叠区域
- 注意:该折叠仅存于当前会话,关文件即丢;不会被
Ctrl+K, Ctrl+J还原,必须单独点开
折叠后 class 名称看不见?检查 fold_buttons 设置
即使 class 成功折叠,若左侧 gutter 没出现 ▶ 或 ▼ 图标,可能是 UI 层按钮被关了,不是折叠逻辑失效。
打开 Preferences → Settings,确保用户设置里有:
{
"fold_buttons": true,
"fade_fold_buttons": false
}
如果 "fold_buttons" 是 false,折叠依然发生(代码变短),但你无法通过点击图标操作——这是最容易被忽略的“看起来没折”原因。











