使用 #region 和 #endregion 可在代码编辑器中创建自定义折叠区域,尤其适用于注释块;在 VS Code 中,通过正确语法如 // #region 描述、/ #region / 或 # region(Python),配合启用折叠功能,即可实现按区域收起或展开代码与注释。

在代码编辑器中配置自定义的代码折叠区域,尤其是针对注释块的折叠,主要依赖于编辑器的功能支持和正确的语法标记。以下以常见的编辑器(如 VS Code)为例,说明如何实现自定义注释块的折叠。
使用特定注释语法触发折叠
某些编辑器允许通过特殊的注释格式来创建可折叠的区域。例如,在 VS Code 中,你可以使用 #region 和 #endregion 来定义一个可折叠的代码块,即使它们位于注释中。
- 在支持的语言中(如 C#、TypeScript、JavaScript),使用:
// #region 描述信息// 这里是你的注释内容或代码// #endregion - 保存后,编辑器会在左侧显示折叠控件,点击即可收起或展开该区域。
在不同语言中的写法示例
虽然语法略有差异,但原理相同。以下是几种常见语言中的写法:
-
JavaScript / TypeScript:
/* #region 自定义注释块 */// 这是一段很长的说明文字.../* #endregion */ -
Python:
VS Code 支持通过# region和# endregion实现折叠(注意空格):# region 数据配置说明# 这里是一大段注释# endregion -
Java / C++:
使用块注释配合 region:/* #region 工具函数说明 */...注释内容.../* #endregion */
启用和调整折叠功能
确保编辑器设置中启用了代码折叠功能:
- 打开 VS Code 设置(Ctrl + ,)
- 搜索 “folding”
- 确认 “Editor: Enable Code Folding” 已开启
- 部分语言可能需要安装扩展才能支持 region 折叠(如 Python)
基本上就这些。只要用对语法,大多数现代编辑器都能识别 region 标记并提供折叠能力。不复杂但容易忽略的是注释符号与 region 关键字之间的空格和格式要正确。










