Sublime如何启用自动展开折叠区域当光标进入？（智能浏览）

sublime text 原生不支持光标进入自动展开折叠区域，需通过插件监听光标位置并调用 expand_at_level 命令实现；fold_all/unfold_all 不适用，因其无上下文感知且破坏用户折叠意图。

sublime text 默认不支持“光标进入自动展开折叠区域”

这是个常见误解：很多人以为 Sublime 有类似 VS Code 的 editor.autoFold 或光标触发展开逻辑，但它原生没有。折叠状态完全由用户手动控制（ctrl+shift+[ / ctrl+shift+]）或通过命令触发，**不会因光标移动自动变化**。

用 expand_at_level + 插件模拟“智能浏览”效果

真正能逼近需求的方案，是监听光标位置，在进入被折叠的代码块时主动调用展开命令。需配合插件实现，核心是 expand_at_level 命令 — 它按缩进层级展开当前行所在区域（比 unfold 更精准）。

• 安装 Package Control 后搜索安装 AutoFold（轻量、无侵入）或手写简单插件
• 若手写，监听 on_selection_modified_async 事件，获取当前行号 → 判断该行是否处于折叠区域（用 view.is_folded(region)）→ 若是，执行 view.run_command("expand_at_level", {"level": 0})
• level: 0 表示展开最内层折叠；设为 1 会尝试展开外层，但容易误展，多数场景用 0 更稳
• 注意性能：频繁调用 is_folded() 在大文件中可能卡顿，建议加行号缓存或节流（如仅当光标跨行时检查）

为什么不用 fold_all / unfold_all？

这两个命令作用于整个视图，和“光标进入才展开”目标完全相悖。强行绑定到光标移动事件会导致：刚展开一处，其他已展开区域又被 unfold_all 清空，体验混乱。

• fold_all 会把所有可折叠区域（包括函数、注释块、import 段）全部收起，不可逆且无上下文感知
• 某些语法（如 Python 的 docstring 折叠）依赖 fold_by_level，而 unfold_all 不区分来源，破坏用户已有折叠意图
• Sublime 的折叠是基于 region 的，不是 AST，所以无法像 LSP 那样知道“这是一个函数体”，只能靠缩进或正则规则匹配 — 这也是自动展开难做准的根本原因

兼容性与实际可用性提醒

Sublime Text 4（Build 4166+）对折叠 API 的稳定性提升明显，但仍有边界情况失效：比如在多光标模式下、或折叠由第三方插件（如 BracketHighlighter）生成时，is_folded() 可能返回 False 即使视觉上是折叠态。

• 确保使用最新版 Sublime Text，旧版（如 3.2）的 expand_at_level 对 JSX/TSX 支持极差
• 如果项目用 sublime-project 配置了 "fold_buttons": false，部分插件的自动展开会静默失败（按钮都禁用了，API 也受限）
• 别指望它像 ide 那样理解语义 — 它只认缩进和预设的 fold rules，遇到非标准缩进或模板字符串里的换行，大概率判断失灵

真要稳定“智能浏览”，得接受它的物理限制：它是个文本编辑器，不是语言服务器。能做的只是让折叠响应更快一点，而不是让它突然变聪明。