VSCode的代码折叠功能通过快捷键、鼠标操作和自动策略实现，依赖语言服务器或缩进分析生成折叠范围，由FoldingController管理状态并通过隐藏行渲染实现视觉收起。
VSCode 的代码折叠功能是编辑器中提升代码可读性和导航效率的重要特性。它允许用户将代码块（如函数、类、注释等）收起，只保留结构轮廓，便于快速浏览和组织代码。
一、如何在 VSCode 中使用代码折叠
在日常开发中，你可以通过以下方式使用代码折叠功能：
-
快捷键操作：
- Ctrl + Shift + [：折叠光标所在或选中区域的代码块。
- Ctrl + Shift + ]：展开已折叠的代码块。
- Ctrl + K, Ctrl + 0：折叠全部代码（例如所有函数）。
- Ctrl + K, Ctrl + J：展开所有代码。
- 鼠标操作： 在代码行号左侧出现的小三角图标点击即可折叠或展开。
- 设置自动折叠策略： 可在设置中搜索“folding”调整是否启用基于缩进的折叠、语言特定的折叠等。
二、代码折叠功能的实现逻辑
VSCode 的代码折叠能力依赖于语言特性和语法结构分析，其核心逻辑位于编辑器的文本模型与语言服务之间。主要流程如下：
-
语法树分析（Tree-sitter 或 Language Server）：
对支持的语言（如 JavaScript、Python、TypeScript），VSCode 会通过语言服务器协议（LSP）获取文档的结构信息。语言服务器提供
FoldingRange请求，返回应被折叠的行范围。 - 基于缩进的回退机制： 若语言不支持 LSP 折叠，则 VSCode 使用基于缩进的启发式算法判断可能的折叠区域。例如连续增加缩进的代码块会被视为可折叠区域。
-
折叠控制器（FoldingController）：
编辑器内部有一个
FoldingController管理所有折叠状态，维护一个FoldingModel记录当前哪些区域被折叠，并响应用户的交互。 - 渲染层更新： 当折叠发生时，编辑器不会真正删除代码，而是通过隐藏对应行的渲染来实现视觉上的“收起”，同时保留原始位置信息以便还原。
三、源码位置与关键模块（GitHub 源码参考）
VSCode 是开源项目，其代码折叠相关实现可在 GitHub 上查看：
- 主仓库地址： https://www.php.cn/link/9a7c22ed48340ab6cd2a273912d51767
-
关键路径：
-
src/vs/editor/contrib/folding/：包含折叠功能的核心实现，如
foldingDecorations.ts、、foldingController.ts。 -
src/vs/editor/common/languages.ts：定义
FoldingRangeProvider接口，供语言扩展实现。 - src/vs/editor/browser/config/configuration.ts：配置项中关于折叠行为的定义。
-
src/vs/editor/contrib/folding/：包含折叠功能的核心实现，如
-
语言服务器接口：
折叠范围由实现了
textDocument/foldingRange方法的服务提供，VSCode 调用该方法获取 JSON-RPC 响应中的 startLine/endLine 信息。
四、自定义语言的折叠支持
如果你正在开发一个语言插件并希望支持智能折叠，可以：
- 在 Language Server 中实现
FoldingRangeProvider。 - 解析 AST，找出函数、循环、条件、注释块等可折叠节点。
- 返回
FoldingRange[]数组，每个对象标明起止行和类型（如 region、comment、imports 等）。 - 启用后，VSCode 将自动显示折叠标记并响应操作。
基本上就这些。VSCode 的代码折叠结合了语言智能与通用规则，既准确又兼容广泛语言场景。理解其实现有助于开发者更好地利用或扩展这一功能。
