鼠标点击侧边栏折叠标记是最直接的折叠方式,需确保fold_buttons为true、文件语法正确识别且缩进规范,否则图标不显示或点击无效。

鼠标点击侧边栏折叠标记(gutter)是最直接的方式
Sublime 的左侧 gutter(行号旁空白区)会自动显示 ▶ 或 ▼ 图标,只要当前行被语法识别为可折叠结构的起始行(如 def、class、function、{),图标就会出现。点击它即可折叠或展开对应块。
但这个功能默认可能被关掉——不是快捷键失效,而是 UI 层没渲染按钮。打开 Preferences → Settings,在右侧用户设置中确认有这行:
"fold_buttons": true
如果还看不到图标,再加一行:
"fade_fold_buttons": false
- 图标只出现在“起始行”上:停在
def foo():行才有 ▶;停在函数体内部、空行、注释行,gutter 保持空白 - 右下角必须显示真实语言名(如
Python),若为Plain Text,gutter 永远不显示折叠按钮 - 点击后折叠状态仅存于当前会话;关闭文件再打开,所有块自动展开
鼠标拖选 + 右键菜单也能折,但不如快捷键顺手
如果你已经用鼠标选中了多行(比如一段 JSON 配置、日志输出或临时注释),可以直接右键 → Fold。这调用的是 fold_selection 命令,和语法无关,100% 可控。
- 适用场景:JSON、YAML、HTML 属性、base64 字符串、无语法支持的配置片段
- 折叠后 gutter 会出现独立三角图标(和语法折叠图标并存),点击即可展开
- 该折叠不写入磁盘,关闭文件即消失;
Ctrl+K, Ctrl+J(unfold_all)不会还原它,必须单独点开 - 注意快捷键差异:Windows/Linux 是
Ctrl+Shift+Alt+[,macOS 是Cmd+Ctrl+Option+[,别和Ctrl+Shift+[混
为什么鼠标点了没反应?先看这三个地方
gutter 没图标、右键菜单没 Fold、或者点了图标却展开失败,通常不是 Sublime 坏了,而是底层条件断了:
- 右下角显示
Plain Text→ 点击它,手动选为Python/JavaScript/JSON等原生支持语法 - Python 文件混用
Tab和Space缩进 →View → Indentation → Convert Indentation to Spaces - 文件过大(>10MB)→ gutter 图标加载延迟,甚至不渲染;此时只能靠
fold_selection手动选区
真正容易被忽略的是:gutter 折叠按钮和快捷键共享同一套作用域识别逻辑。如果 Ctrl+Shift+[ 在 def 行按不动,那 gutter 图标也一定不会出现——问题不在鼠标,而在语法解析是否成功。











