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

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 关键字的行：

• 保存为 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)</pre></li>

• 该命令依赖 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

手动选区折叠为何比插件更值得优先尝试

几乎所有插件都受限于语法识别、作用域解析或正则误匹配，而 fold_selection 命令完全绕过这些层，是唯一能在任意文件类型（.env、.log、.json、甚至未保存的临时缓冲区）中立刻生效的方式：

• 操作路径极简：鼠标拖选 → Ctrl+Shift+Alt+[（Windows/Linux）或 Cmd+Ctrl+Option+[（macOS）
• 折叠后左侧 gutter 出现独立三角图标，点击即展开，不干扰其他自动折叠块
• 它不写入文件、不依赖任何设置，关文件就消失——这反而是优势：避免误存错误折叠状态到团队共享代码中
• 真正容易被忽略的一点：该命令在 Sublime 启动后首次使用前，可能因插件加载延迟而失败；若第一次按没反应，稍等 1–2 秒再试一次即可