VSCode默认按语法结构折叠，手动折叠需用#region/#endregion标记。它跨语言通用，依赖显式标记而非缩进，嵌套需严格配对；若无效，需检查语言模式、folding设置及扩展干扰；折叠状态不持久，且影响光标定位与跳转。
VSCode 的区域折叠功能默认对语言语法结构（如函数、类、if 块）自动生效，但无法直接折叠任意代码段——除非你显式标记它们。
用 #region 和 #endregion 手动创建可折叠区域
这是最通用、跨语言（支持 TypeScript/JavaScript/Python/C#/C++ 等多数语言）的方式。VSCode 识别这两行作为折叠边界，不依赖缩进或语法结构。
-
#region后可跟任意描述文字（如#region API handlers），不影响折叠逻辑 -
#endregion必须单独成行，且不能带注释或其他内容（否则折叠可能失效） - 嵌套
#region是允许的，但需严格配对；VSCode 不校验嵌套合法性，错配会导致折叠异常 - 在 Python 中需确保文件顶部有
# -*- coding: utf-8 -*-或类似编码声明，否则部分旧版插件可能误判#region为普通注释而忽略
检查当前语言是否启用折叠支持
不是所有语言模式都默认开启自定义区域折叠。若 #region 无反应，先确认：
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Developer: Toggle Developer Tools，查看 Console 是否报错Folding provider not available - 检查当前文件右下角语言模式是否正确（如 .ts 文件显示为
TypeScript而非Plain Text） - 在
settings.json中确认未禁用："editor.folding": true（默认为true） - 某些扩展（如 Prettier）可能干扰折叠逻辑，可临时禁用验证
折叠行为与快捷键的实际表现
折叠后，VSCode 显示省略号 … 和区域描述（若有），但关键细节容易被忽略：
- 鼠标悬停在折叠行上会显示完整首行和末行内容，但不会展开——必须点击左侧空隙或使用快捷键
- 默认折叠快捷键是
Ctrl+Shift+[（折叠）和Ctrl+Shift+]（展开），但仅作用于光标所在区域层级；想折叠全部，用Ctrl+K Ctrl+0 - 折叠状态不保存到文件中，重启 VSCode 后恢复为默认展开；如需持久化，需安装扩展如
fold-level或手动配置editor.foldingStrategy - 被折叠的代码仍参与语法检查、跳转和搜索，但正则替换默认不跨折叠区域匹配（需勾选
Match Whole Word或关闭Use Regular Expression）
真正难调试的不是怎么折，而是折叠后光标位置丢失、跳转目标被隐藏、或者团队协作时有人删了 #endregion 却没发现——这些地方比功能本身更常出问题。
