VSCode默认支持代码折叠，基于语言语法识别function、class、if等语句块、注释块、导入语句及JSON/YAML对象数组；需确保语言模式正确、折叠策略设为"auto"且扩展正常。
vscode 默认支持代码折叠，不需要额外安装插件，但具体行为取决于语言、语法结构和设置。
哪些代码块能被自动折叠？
VSCode 基于语言的语法定义（Language Grammar）识别可折叠区域。常见支持折叠的结构包括：
-
function、class、if、for、while等语句块（需有大括号{}或缩进） - 注释块（如
/* ... */或连续多行//注释） - 导入/引用语句（如 Python 的
import块、TypeScript 的import type分组） - JSON/YAML 中的对象和数组（需开启
"editor.foldingStrategy": "indentation"或使用语言服务）
不是所有语言都默认启用完整折叠支持。例如纯文本或未配置语言模式的文件，只支持基于缩进的折叠。
快捷键：折叠/展开当前层级
最常用的操作是局部收放，不干扰其他区域：
- 折叠光标所在区域：
Ctrl + Shift + [（Windows/Linux）或Cmd + Shift + [（macOS） - 展开光标所在区域：
Ctrl + Shift + ]（Windows/Linux）或Cmd + Shift + ]（macOS） - 折叠全部：
Ctrl + K，然后松开，再按Ctrl + 0 - 展开全部：
Ctrl + K，然后松开，再按Ctrl + J
注意：Ctrl + K 是“命令前缀”，后续按键必须在 1 秒内跟上，否则会失效。
为什么有些代码明明有大括号却不能折叠？
常见原因有三个：
- 文件未正确识别语言模式（右下角显示为
Plain Text），点击切换为对应语言（如JavaScript） - 语言扩展未激活或崩溃（尝试重载窗口：
Ctrl + Shift + P→ 输入Developer: Reload Window） - 折叠策略被设为
indentation，而当前语言（如 TypeScript）依赖语法解析器，需设为auto："editor.foldingStrategy": "auto"
该设置可写在用户设置（全局）或工作区 .vscode/settings.json 中。
自定义折叠区域（#region / #endregion）
部分语言（如 TypeScript、C#、Python）支持用注释标记折叠区域：
// #region 数据处理逻辑
const a = 1;
function foo() { /* ... */ }
// #endregion启用前提：
- 确保语言支持（TypeScript 默认支持；Python 需安装 Pylance 或 Python 扩展并启用
"python.analysis.extraPaths"不影响此功能） - 确认设置中未禁用：
"editor.foldingStrategy": "auto"
（indentation模式下#region无效） - 注释符号必须与语言匹配（TypeScript 用
//，Python 用#）
折叠标记本身不会被语法检查忽略，但也不会影响运行——它们只是编辑器提示。
折叠功能看似简单，但实际生效高度依赖语言服务状态和设置组合。如果某段代码始终无法折叠，优先检查右下角语言标识和 editor.foldingStrategy 设置，而不是怀疑代码写法。
