Sublime利用插件增强代码折叠功能的方法-sublime-PHP中文网

sublime原生不折叠if/for等逻辑块，因语法定义缺foldingstartmarker；需用brackethighlighter+codefold配正则规则，或用fold_selection手动选区折叠。

sublime利用插件增强代码折叠功能的方法

BracketHighlighter + CodeFold 实现细粒度折叠

原生 Sublime 对 if/for/while 块、单行函数体、装饰器包裹的函数等结构默认不折叠，根本原因是语法定义里没配 foldingStartMarker。BracketHighlighter 插件本身不提供折叠，但配合 CodeFold（或其替代插件如 Fold Comments）可基于括号配对或正则匹配扩展折叠能力。

安装后需手动配置正则规则才能生效，比如让 def 行触发折叠：

打开 Preferences → Package Settings → CodeFold → Settings

在用户设置中添加针对 Python 的折叠规则：

{
  "fold_regexes": [
    ["^\s*def\s+\w+\s*\(.*?\)\s*:", "^\s*#\s*endregion"]
  ]
}

注意：正则必须能精准匹配声明行，且不能跨行；# endregion 是可选终止符，不写则默认折到下一个同级缩进开始处
JS 用户可类似配置 ^\s*(function|const\s+\w+\s*=\s*function)，但需避开字符串和注释内的匹配——建议启用 ignore_in_comments 和 ignore_in_strings

自定义命令实现「只折函数」的稳定方案

官方 fold_by_level 不保证函数级统一，因为不同语法包中 meta.function 所在 scope depth 不一致。更可控的方式是写一个轻量 TextCommand，只识别并折叠含 def 或 function 关键字的行：

FaceSwapper

FaceSwapper是一款支持照片、视频和 GIF 换脸的在线 AI 换脸工具。

下载

保存为 Packages/User/FoldFunctions.py：

import sublime
import sublime_plugin
<p>class FoldFunctionsCommand(sublime_plugin.TextCommand):
def run(self, edit):
view = self.view
regions = []
for region in view.find_by_selector("entity.name.function"):
line = view.line(region)</p><h1>向下找缩进块结束位置（简化版，实际需校验缩进变化）</h1><pre class="brush:php;toolbar:false;">        next_line = view.line(line.end() + 1)
        if view.indentation_level(next_line.begin()) < view.indentation_level(line.begin()):
            regions.append(sublime.Region(line.begin(), next_line.begin()))
    view.fold(regions)

该命令依赖 entity.name.function 作用域，所以仍需确保语法已正确加载（右下角不是 Plain Text）
绑定快捷键时注意：它不会处理装饰器跨行、docstring 紧贴 def 等边界情况，加空行是最简单规避方式

region 注释折叠失效的排查与修复

// region 和 # region 不是通用开关，是否生效取决于当前语法是否启用 fold_comment 规则，以及注释格式是否被严格识别：

必须顶格写：// region utils ✅， // region utils ❌（前面有空格就失效）
配对要完整：// region 必须对应 // endregion，中间不能混入 /* */ 块
Python 中仅官方 Python 语法支持 # region，第三方插件如 Python Improved 通常删掉了该规则
验证方法：光标停在 // region 行，按 Ctrl+Shift+P → Developer: Show Scope Name，若状态栏出现 comment.block.region 才算被识别
如果没出现，临时切回原生语法：Ctrl+Shift+P → Set Syntax: Python 或 JavaScript