Sublime如何快速收起所有函数？Sublime代码折叠层级操作技巧

Sublime需正确识别语言作用域才能折叠函数，验证方法为光标置于def行后执行show_scope_name命令；批量折叠函数应使用fold_by_level命令并实测作用域层级数字，而非缩进折叠。

Sublime 默认不支持“只折函数”，得靠作用域识别

很多开发者习惯性地按下 Ctrl+Shift+[，却发现代码纹丝不动。问题往往不在于快捷键，而在于Sublime Text的折叠机制本身。它的核心逻辑是基于语法作用域，而不是简单地数缩进或者寻找 def 这类关键字。编辑器默认确实能折叠函数，但有两个硬性前提：首先，文件必须被正确识别为对应语言（比如右下角显示 Python，而不是 Plain Text）；其次，该语言的语法定义文件里，必须明确定义了函数块的起止标记。如果语言没选对，后续所有操作都无从谈起。

如何验证？其实有个非常直接的方法：将光标移动到任意一个 def 行，然后打开命令面板（Ctrl+Shift+P 或 macOS 的 Cmd+Shift+P），输入并执行 show_scope_name。如果状态栏显示类似 source.python meta.function.python 这样的内容，恭喜你，函数作用域已被成功识别。反之，如果只看到 source.python，那就意味着语法高亮可能失效了，或者存在插件冲突，需要优先排查。

怎么批量折叠所有函数定义（非缩进式）

接下来是另一个常见误区：试图通过 Ctrl+K Ctrl+0 或者菜单里的 Fold All 来一键收起所有函数。这个方法行不通，因为它们依据的是缩进层级。结果就是，不仅函数被折叠了，连带着里面的 if、for 循环，甚至大段的注释块也会被一并收起来，这显然不是我们想要的“仅折叠函数定义”。

那么，正确的批量操作姿势是什么？答案是使用命令面板中的 fold_by_level 命令，并指定一个代表函数层级的数字。具体步骤可以这样走：

• 首先，手动用 Ctrl+Shift+[ 成功折叠一个函数，确保当前文件的函数块能被正常识别。
• 然后，唤出命令面板（Ctrl+Shift+P），输入 fold_by_level 并回车。
• 此时，编辑器会等待你输入一个数字。对于Python，这个数字通常是 2；对于Ja vaScript，则可能是 3。但请注意，这并非固定值。
• 最关键的一步是“实测”：如果输入后没反应，不要慌，依次尝试输入1、2、3、4等数字，直到所有函数被一次性折叠起来为止。

这个数字背后的逻辑，是当前语法文件中 meta.function 这类作用域所在的嵌套深度。因此，不同的语法插件或者自定义的语法包，都可能会改变这个值，所以实测才是王道。

常见失效场景和绕过方式

即便语法正确，在某些特定写法下，函数折叠依然可能失效。以下是几个典型的“坑”：

• Docstring紧贴函数定义：例如写成 def f(): """doc"""; pass，函数定义行后紧跟文档字符串且没有换行。Sublime的解析器可能会因此跳过整个块。解决办法很简单，在def行和docstring之间加一个空行即可。
• 非标准语法结构：比如装饰器跨越多行、使用了 @overload 但后面没有函数体，或者类型提示过长导致解析中断。这些情况都可能干扰作用域的识别。
• 自定义语法插件：安装了一些增强语法高亮的插件（如某些Vue或TypeScript插件），但如果其 .sublime-syntax 文件没有正确定义折叠规则，功能就会缺失。
• 非标准文件后缀：像 .pyi（存根文件）或 .j2（Jinja2模板）这类后缀，Sublime可能无法自动关联语法，需要手动从右下角语言菜单中选择。

如果遇到上述问题，有个临时的补救措施：利用搜索功能选中所有函数定义行。按下 Ctrl+F，搜索 ^def （记得勾选“正则表达式”和“匹配行首”），然后点击“查找全部”。这样会选中所有匹配的行，此时再按下 Ctrl+Shift+[，编辑器会以每个选区为锚点，分别触发折叠。

折叠按钮不显示？检查两个设置项

有时候，你会发现代码行左侧没有出现那个用于折叠的小三角按钮。这通常不是功能被禁用，而是视觉上被隐藏了，或者相关配置缺失。可以按以下步骤检查：

• 打开 Preferences → Settings，在右侧的用户设置文件中，确保包含 "fold_buttons": true 这一行。
• 如果按钮一闪而过，可以额外添加一行 "fade_fold_buttons": false，让折叠按钮常驻显示。
• 需要明确的是，这两个设置只控制界面按钮的可见性，不影响通过快捷键或命令面板进行的折叠操作。

话说回来，绝大多数情况下，按钮不显示的根源，还是前面提到的那个核心前提——Sublime Text根本没有将那段代码识别为函数作用域。所以，当按钮消失时，首先应该怀疑的是作用域识别问题，而不是界面配置。