如何配置VSCode的代码折叠规则？

VSCode代码折叠默认基于语法结构，可通过设置"editor.foldingStrategy"为"indentation"改用缩进策略；可用"#region"/"#endregion"标记自定义折叠区域；支持在settings.json中配置HTML等语言的自定义折叠正则；还可通过Region Folder等扩展增强折叠功能，提升长文件浏览效率。

VSCode的代码折叠功能默认基于语言的语法结构（如函数、类、注释块等）自动识别可折叠区域，但你可以通过设置和插件来自定义或增强折叠行为。以下是几种常见的配置方式：

1. 启用/关闭基于缩进的折叠

某些语言（如Python）没有明显的代码块符号（如大括号），VSCode支持按缩进来折叠代码。

"editor.foldingStrategy": "indentation" 可在设置中将折叠策略改为基于缩进。默认是 "auto"，会优先使用语言服务提供的折叠范围。

操作方法：

• 打开设置（Ctrl + ,）
• 搜索 “folding strategy”
• 选择 Editor › Folding Strategy，设为 indentation

2. 使用区域标记手动定义折叠块

你可以用特殊的注释标记来创建自定义折叠区域，这对长段逻辑或配置项特别有用。

支持的语言包括 JavaScript、TypeScript、Python、C++、Java 等。

语法格式：

// #region 描述文本 ... 可折叠的内容 // #endregion

示例（JavaScript）：

// #region 工具函数 function helperA() { ... } function helperB() { ... } // #endregion

VSCode会识别这些标记并显示折叠控件。你也可以在标记后加说明，提高可读性。

代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手，覆盖软件需求分析、架构设计、代码编写、软件测试等环节

51

查看详情

3. 自定义区域标记（适用于非默认语法）

如果使用的语言不支持 #region，或者你想用其他关键字（如 <!-- fold -->），可以通过 settings.json 配置：

打开 settings.json：

• Ctrl + Shift + P → 输入 “Preferences: Open Settings (JSON)”

添加自定义标记（以HTML为例）：

"html.foldingRanges.provider": "embedded", "editor.foldingRanges.customRegions": {   "start": "<!--s*#?regionb",   "end": "<!--s*#?endregionb" }

这样就能在HTML中使用：

<!-- region 展开说明 --> <div>...</div> <!-- endregion -->

4. 安装增强折叠功能的扩展

某些语言或场景下默认折叠不够用，可以安装扩展提升体验：

• Region Folder：为 #region 提供树形分层折叠
• Custom Folding：支持更多自定义折叠语法
• Python 扩展自带对类、函数、注释块的智能折叠

安装后通常无需额外配置，重启编辑器即可生效。

基本上就这些。合理使用 region 标记和折叠策略，能大幅提升长文件的浏览效率。注意不同语言的细节可能略有差异，建议结合语言扩展文档调整。