怎样配置自定义的代码折叠区域，比如折叠一个自定义的注释块？-VSCode-PHP中文网

怎样配置自定义的代码折叠区域，比如折叠一个自定义的注释块？

狼影

发布： 2025-10-07 22:40:02

原创

672人浏览过

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

怎样配置自定义的代码折叠区域，比如折叠一个自定义的注释块？

在代码编辑器中配置自定义的代码折叠区域，尤其是针对注释块的折叠，主要依赖于编辑器的功能支持和正确的语法标记。以下以常见的编辑器（如 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 */