VSCode折叠范围提供者配置

VSCode通过内置提供者和扩展支持智能代码折叠，可结合语言特性与#region标记自定义区域，确保editor.folding启用并检查语言模式与扩展兼容性以优化代码结构展示。

在 VSCode 中配置折叠范围提供者（Folding Range Provider），可以让编辑器根据语言特性或自定义规则智能地识别代码中可折叠的区域，比如函数、类、注释块等。这通常用于扩展开发，但也可以通过设置影响内置行为。

启用或禁用折叠范围提供者

VSCode 默认为大多数语言启用了内置的折叠范围提供者。如果你发现折叠功能异常，可以检查相关设置：

• 打开设置（Ctrl+, 或 Cmd+,）
• 搜索 editor.folding
• 确保“Editor › Folding”设为 true 以启用代码折叠
• 可设置 “Editor: Fold By Default” 控制默认折叠级别（如 block, region, keyword 等）

使用语言扩展自定义折叠行为

某些语言服务（如 TypeScript、Python、Lua）通过语言服务器协议（LSP）提供更精确的折叠范围。你可以通过安装扩展来增强折叠能力：

• 安装官方或社区语言扩展（如 Python、Pylance、Lua for VSCode）
• 扩展若实现了 FoldingRangeProvider 接口，会自动注册到编辑器
• 折叠逻辑由扩展决定，例如根据语法树生成函数、类、控制块等范围

手动添加折叠标记（区域折叠）

即使语言不支持智能折叠，也可使用标记手动定义可折叠区域：

美图云修

商业级AI影像处理工具

61 查看详情 • 在支持的语言中使用：
// #region 描述
...代码...
// #endregion
• 对于其他语言，可用类似语法，如：
/* #region */ 和 /* #endregion */
• 区域折叠不受语言服务器影响，始终可用

调试折叠行为

如果折叠未按预期工作，可通过以下方式排查：

• 检查当前语言模式是否正确（右下角显示语言）
• 禁用其他可能冲突的折叠相关扩展
• 查看开发者工具（帮助 → 开发者工具）是否有报错
• 测试在新文件中使用 #region 是否生效

基本上就这些。VSCode 的折叠功能依赖语言服务和用户标记共同作用，合理配置能让代码结构更清晰。

以上就是VSCode折叠范围提供者配置的详细内容，更多请关注其它相关文章！