VSCode 代码折叠功能可提升长文件阅读效率：一、默认支持语法感知折叠，用快捷键 Cmd+Option+[/] 或点击三角图标操作；二、通过 // #region 自定义折叠区域；三、可在设置中调整 foldingStrategy 等参数优化体验。
如果您在使用 vscode 编写较长的代码文件时感到视觉混乱，难以快速定位关键逻辑段落，则可能是由于大量嵌套结构或重复代码块干扰了阅读节奏。代码折叠功能可帮助您临时隐藏非核心区域，聚焦当前处理的部分。
本文运行环境：MacBook Air，macOS Sequoia。
一、启用默认折叠支持
VSCode 默认已为多数主流语言（如 JavaScript、Python、TypeScript、HTML）内置语法感知型折叠规则，无需额外插件即可使用。该机制基于缩进层级与语言结构（如函数定义、类声明、条件块）自动识别可折叠范围。
1、打开任意支持折叠的语言文件（例如 .py 或 .js 文件）。
2、将光标置于某段可折叠代码行（如函数首行、if 块起始行）左侧的空隙区域，出现浅灰色小三角图标。
3、点击该三角图标，即可收起或展开对应代码块。
4、按 Ctrl+Shift+[（Windows/Linux）或 Cmd+Option+[（macOS）折叠当前光标所在区域。
5、按 Ctrl+Shift+]（Windows/Linux）或 Cmd+Option+]（macOS）展开当前光标所在区域。
二、自定义折叠区域
对于不被默认规则覆盖的代码段（如大段注释、配置对象、临时屏蔽的调试代码），可通过添加特殊注释标记手动创建折叠区域，增强组织灵活性。
1、在希望折叠的代码起始位置上方插入一行：// #region。
2、在希望折叠的代码结束位置下方插入一行：// #endregion。
3、保存文件后，VSCode 将在 #region 行左侧显示折叠控件，点击即可收起整段内容。
4、可在 #region 后添加描述性文本，例如 // #region 数据处理逻辑 ，便于快速识别折叠内容用途。
三、调整折叠行为设置
VSCode 允许通过配置项控制折叠的灵敏度与范围，例如是否启用基于缩进的通用折叠、是否折叠导入语句等，以适配不同开发习惯。
1、按下 Cmd+,（macOS）打开设置界面。
2、在搜索框中输入 editor.foldingStrategy，将值设为 indent 可启用缩进级折叠（适用于无语法支持的文件类型）。
3、搜索 editor.showFoldingControls，选择 mouseover 可使折叠控件仅在鼠标悬停时显示，减少视觉干扰。
4、搜索 editor.foldingImportsByDefault，启用后将自动折叠 Python 的 import 块或 JavaScript 的 import 语句组。
