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() { ... }
// #endregionVSCode会识别这些标记并显示折叠控件。你也可以在标记后加说明,提高可读性。
citySHOP是一款集CMS、网店、商品、系统,管理更加科学快速;全新Jquery前端引擎;智能缓存、图表化的数据分析,手机短信营销;各种礼包设置、搭配购买、关联等进一步加强用户体验;任何功能及设置都高度自定义;MVC架构模式,代码严禁、规范;商品推荐、促销、礼包、折扣、换购等多种设置模式;商品五级分类,可自由设置分类属性;商品展示页简介大方,清晰,图片自动放大,无需重开页面;商品评价、咨询分开
3. 自定义区域标记(适用于非默认语法)
如果使用的语言不支持 #region,或者你想用其他关键字(如 ),可以通过 settings.json 配置:
打开 settings.json:
- Ctrl + Shift + P → 输入 “Preferences: Open Settings (JSON)”
添加自定义标记(以HTML为例):
"html.foldingRanges.provider": "embedded",
"editor.foldingRanges.customRegions": {
"start": "
...
4. 安装增强折叠功能的扩展
某些语言或场景下默认折叠不够用,可以安装扩展提升体验:
- Region Folder:为 #region 提供树形分层折叠
- Custom Folding:支持更多自定义折叠语法
- Python 扩展自带对类、函数、注释块的智能折叠
安装后通常无需额外配置,重启编辑器即可生效。
基本上就这些。合理使用 region 标记和折叠策略,能大幅提升长文件的浏览效率。注意不同语言的细节可能略有差异,建议结合语言扩展文档调整。









