右下角显示 Plain Text 时自动折叠失效,因Sublime依赖语法定义而非缩进;需手动选语言或用正确扩展名,光标须在foldingStartMarker行(如def、function),fold_all收起全部顶层结构,fold_by_level按作用域嵌套深度折叠,手动选区折叠不依赖语法。

右下角显示 Plain Text 就别指望自动折叠
Sublime Text 的自动折叠完全依赖语法定义,不是靠猜内容或缩进。如果右下角状态栏显示的是 Plain Text、Unsupported syntax 或某个插件自定义的非标准语法名(比如 Vue Component),那所有基于语法的折叠规则都直接失效——Ctrl+Shift+[ 按了也没反应,不是快捷键坏了,是根本没启动折叠引擎。
解决办法只有两个:
• 点击右下角文字 → 手动选为 Python、JavaScript、JSON 等官方支持的语言
• 保存文件时带正确扩展名(如 main.py、index.js),Sublime 才会自动关联语法
若仍不生效,临时禁用插件(尤其是旧版 Vue/YAML 插件),它们常会劫持语法识别逻辑
光标必须落在 foldingStartMarker 行上
自动折叠不是“选中就折”,而是“光标在哪行,就折它所属的最内层可折叠块”。这个“起点行”由语法文件里的 foldingStartMarker 正则定义,比如 Python 看 def 和 class,JS 看 function 和 {,HTML 看 <div>。
常见失败场景:
• 光标停在 print("hello") 这类函数体内行,不响应 Ctrl+Shift+[
• 光标在空行、注释行、字符串内部,命令静默失败
• 光标在 } 或 endif 上,折叠起点必须是开始标记所在行
验证是否命中:按 Ctrl+Shift+P → 输入 Developer: Show Scope Name,看输出里有没有 meta.function、meta.class、meta.block 这类带 meta. 前缀的作用域
fold_by_level 和 fold_all 的行为差异
Ctrl+K, Ctrl+0 调用 fold_all,它不看层级,只遍历当前视图所有已识别的折叠点,一键收起全部顶层结构(如所有 def、class、if 块)。而 Ctrl+K, Ctrl+N(N 是数字)调用 fold_by_level,它按语法定义中的 fold_level 值折叠——但这个值不是缩进空格数,是作用域嵌套深度。
实操要点:
• Ctrl+K, Ctrl+1:通常折顶层 import、全局变量、if __name__ == "__main__":
• Ctrl+K, Ctrl+2:再往里一层,比如类内部方法、函数体内的 for/if 块
• Python 文件中 def 和 class 多数在 level 1,JS 中 function 块可能在 level 2
注意:必须先松开 Ctrl+K 再按数字键;输错数字不会报错,只是没反应
手动选区折叠是最可靠的兜底方案
当语法不支持(比如 YAML、TOML)、自定义 DSL、或者你只想临时收起一段日志、配置 JSON、测试数据时,fold_selection 是唯一不依赖语法定义、无需改设置、不装插件的解法。
操作步骤:
• 鼠标拖选任意连续多行(哪怕全是注释或空行)
• 按 Ctrl+Shift+Alt+[(Windows/Linux)或 Cmd+Ctrl+Option+[(macOS)
• 侧边栏会出现独立小箭头,点击即可展开/收起
这种折叠只存在于当前会话,关闭文件即消失,但它 100% 可控,且不会干扰其他自动折叠块
真正容易被忽略的是:所有语法规则生效的前提,是 Sublime 正确识别了语言并加载了对应语法文件。一旦 Developer: Show Scope Name 返回的 scope 链里没有 meta. 前缀,或者 foldingStartMarker 根本没在语法文件里定义,再调什么命令都没用——这不是设置问题,是基础识别链断了。


















