VSCode代码折叠依赖语言扩展和设置，支持语法或缩进折叠；function、if、class等语法块及HTML标签默认可折，JSON/YAML仅支持缩进折叠；快捷键Ctrl+Shift+[折叠当前区域，Ctrl+K Ctrl+0折叠全部；不可折常见原因包括语言模式错误、缺少扩展或文件过大。
VSCode 默认支持大多数语言的代码折叠，但具体行为取决于语言扩展、文件类型和设置，不是所有代码块都能自动折叠，也不能靠快捷键“一键全折”。
哪些代码块能被折叠
VSCode 折叠基于语法（semantic folding）或缩进（indentation-based folding）。是否可折叠，取决于当前语言扩展是否提供 foldingProvider。例如：
-
function、if、for、class等语法块，在 JavaScript/TypeScript、Python、Java 等语言中通常默认可折叠 - HTML 中的
<div>、<section>标签块默认可折叠（依赖内置 HTML 语言支持） - 注释块（如
/* ... */或//连续多行）在启用"editor.foldingStrategy": "indent"后可能按缩进折叠，但不推荐依赖此方式 - JSON、YAML 等纯数据格式默认不支持语法级折叠，仅支持缩进折叠（需手动开启）
常用折叠快捷键与鼠标操作
快捷键是最快捷的控制方式，但要注意平台差异和焦点状态：
- 折叠当前光标所在区域：
Ctrl+Shift+[（Windows/Linux）或Cmd+Option+[（macOS） - 展开当前光标所在区域：
Ctrl+Shift+]（Windows/Linux）或Cmd+Option+]（macOS） - 折叠全部：
Ctrl+K Ctrl+0（注意是数字零，不是字母 O） - 展开全部：
Ctrl+K Ctrl+J - 鼠标点击编辑器左侧的折叠控件（小三角）即可切换，但只对已识别的可折叠区域生效
折叠不生效的常见原因与修复
如果明明写了 function 却无法折叠，大概率不是 VSCode 坏了，而是配置或环境没对上：
- 当前文件未被识别为对应语言：检查右下角语言模式（如显示为
Plain Text），点击后手动选为JavaScript或对应语言 - 缺少对应语言扩展：比如打开 .py 文件却没装 Python 扩展，则 Python 的
def、class折叠不会启用 -
"editor.foldingStrategy"被设为"auto"但语言扩展未提供折叠支持 → 可临时改为"indent"（在settings.json中加："editor.foldingStrategy": "indent"
），但会把所有缩进层级都当折叠单元，容易误折 - 文件过大（>5000 行）时，VSCode 可能禁用语法折叠以保性能；此时可调大
"editor.foldingMaximumRegionLength"（默认 5000）
自定义折叠区域（#region / #endregion）
部分语言（如 TypeScript、C#、Java）支持通过注释标记手动定义折叠区域，VSCode 原生识别这些标记：
- TypeScript/JavaScript 中可用：
// #region My Section<br>console.log('inside');<br>// #endregion - Java 中类似：
// region Helper Methods<br>private void helper() { }<br>// endregion - 要启用该功能，确保
"editor.foldingStrategy"是"auto"（默认值），且语言扩展支持（如官方 Java 扩展、TypeScript 自带） - 注意：Python 官方扩展默认不支持
#region，需安装额外插件（如Python Docstring Generator不提供此功能，应选Python Indent类扩展或改用缩进折叠）
折叠逻辑高度依赖语言服务，而不是编辑器本身；同一个 if 块在 JS 文件里能折，在 .txt 里一定不能折——别调设置，先看右下角语言模式。
