VSCode代码折叠功能可提升大型文件浏览效率：默认支持多语言结构折叠；提供Cmd+Shift+[等快捷键批量控制；支持#region自定义区域；可通过设置调整折叠策略；扩展可增强高级折叠能力。
如果您在使用 VSCode 编辑大型源文件时发现代码结构难以快速浏览，代码折叠功能可帮助您临时隐藏不相关的代码块，从而聚焦于当前逻辑区域。以下是启用与自定义代码折叠的具体操作方式：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用默认代码折叠支持
VSCode 默认对多种语言的常见结构（如函数、类、条件块、循环等）提供原生折叠支持，无需额外插件即可使用。该功能依赖语言服务器提供的语法范围信息，确保折叠边界准确可靠。
1、打开任意支持折叠的语言文件（例如 .ts 或 .py 文件）。
2、将光标置于某段可折叠代码行号左侧的空白区域，出现 ▶ 或 ▼ 图标时单击即可折叠或展开。
3、按住 Option 键（macOS）并点击折叠图标，可递归折叠其内部所有嵌套层级。
二、使用快捷键批量控制折叠状态
键盘操作能显著提升折叠效率，尤其适用于快速收起整个文件或逐级展开调试。所有快捷键均基于编辑器焦点触发，不依赖鼠标定位。
1、折叠当前光标所在区域：Cmd + Shift + [（macOS）。
2、展开当前光标所在区域：Cmd + Shift + ]（macOS）。
3、折叠全部代码块：Cmd + K 后松开，再按 Cmd + 0。
4、展开全部代码块：Cmd + K 后松开，再按 Cmd + J。
三、自定义折叠区域（#region / #endregion）
对于不支持自动结构识别的语言（如 HTML、JSON），或需要手动划定逻辑分组的场景，可通过预设注释标记创建用户定义折叠区域。该方式兼容 TypeScript、JavaScript、C# 等主流语言。
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
1、在代码中插入开始标记：// #region 描述文字。
2、在对应位置插入结束标记：// #endregion。
3、保存文件后，VSCode 将在开始标记左侧显示折叠控件，点击即可收起两标记之间的全部内容。
四、配置折叠行为以匹配开发习惯
VSCode 允许通过设置项调整折叠策略，例如禁用自动折叠导入语句、启用缩进级折叠等，使编辑器响应更符合个人工作流。
1、按下 Cmd + , 打开设置界面。
2、在搜索框中输入 folding，定位到 Editor: Folding Strategy 选项。
3、下拉选择 indentation 可启用基于缩进的通用折叠（适用于无语法支持的文件）。
4、勾选 Editor > Folding: Enabled 确保全局折叠功能处于激活状态。
五、安装扩展增强折叠能力
部分第三方扩展可在原生功能基础上补充高级特性，例如按正则表达式定义折叠范围、可视化折叠层级图、跨文件同步折叠状态等。
1、打开 VSCode 左侧活动栏中的扩展视图（Cmd + Shift + X）。
2、搜索关键词 fold，安装评分高于 4.5 且更新时间在三个月内的扩展，例如 Folding Indent 或 Custom CSS and JS Loader（需配合自定义脚本）。
3、重启 VSCode 使扩展生效，部分扩展需在设置中启用对应语言的支持开关。
