VSCode代码折叠默认开启，按语言语法和内置提供器规则折叠函数、类、注释等；支持#region自定义区域；快捷键为Ctrl+Shift+[ / ]（macOS为Cmd），需注意输入法、键盘布局及焦点位置；折叠仅视觉生效，不影响代码分析与执行。
VSCode 的代码折叠功能默认开启，不需要额外安装插件，但很多开发者没意识到它对不同语言、不同结构的折叠行为差异很大——关键不是“能不能折”，而是“按什么规则折”和“怎么让折叠更符合你的工作流”。
哪些代码块默认可折叠
VSCode 基于语言语法（Language Server）和内置折叠提供器（folding provider）决定可折叠范围。常见支持：
-
function、if、for、while等语句块（JavaScript/TypeScript/Python/Go 等主流语言均支持） - 类（
class）、接口（interface）、命名空间（namespace）等声明体 - 注释块（以
/* ... */包裹的多行注释，部分语言如 C/C++/Java 支持；Python 的三引号字符串"""..."""默认不折叠，需配置） - JSON/YAML 文件中对象和数组层级（VSCode 1.80+ 原生支持）
折叠快捷键与鼠标操作不一致？检查键盘映射
默认快捷键是 Ctrl+Shift+[（折叠）和 Ctrl+Shift+]（展开），但在 macOS 上对应 Cmd+Shift+[。容易出错的点：
- 输入法处于中文状态时，
[和]键可能被拦截，导致快捷键失效 - 某些键盘布局（如 Dvorak 或自定义键位）下，
[/]物理位置变化，但 VSCode 仍按标准键位绑定 - 终端或调试控制台聚焦时，快捷键会作用于终端而非编辑器 —— 确保光标在代码编辑区
可在设置中搜索 folding，确认 editor.folding 为 true，并检查 keybindings.json 是否被其他扩展覆盖了折叠快捷键。
自定义折叠区域：用 // #region 和 // #endregion
当语法级折叠不够用（比如想把一组相关配置、一段临时注释掉的逻辑、或跨函数的业务模块收起），VSCode 支持手动标记折叠区域：
// #region API 配置 const baseUrl = 'https://api.example.com'; const timeout = 5000; // #endregion
注意细节：
- 必须成对出现，且
#region和#endregion后面的描述文本可选，但不能换行 - 支持嵌套，但深度过大会影响性能（建议不超过 3 层）
- JavaScript/TypeScript/Python/C# 等语言原生支持；CSS/HTML 需要安装扩展（如
Region Folder）才能启用 - 区域折叠优先级高于语法折叠 —— 即使内部有
if块，也会被整个#region包裹住
折叠后跳转困难？别忽略折叠状态对导航的影响
折叠本身不影响代码执行或 LSP 功能（如跳转定义、查找引用），但会影响以下操作：
-
Ctrl+F查找默认只在展开内容中匹配，折叠区域内的文本不会高亮或定位 - 大纲视图（Outline）仍显示所有符号，但点击折叠后的
function会直接跳到首行，而非展开它 - 使用
Ctrl+G跳转行号时，如果目标行在折叠块内，VSCode 会自动展开该区域 —— 这是默认行为，不可关闭 - Git 差异对比中，折叠状态不保存，每次打开文件都会重置为默认折叠状态
真正容易被忽略的是：折叠只是视觉操作，不改变 AST 结构，所以 ESLint、Prettier 等工具完全感知不到你是否折叠了某段代码 —— 别误以为“折起来就等于暂时禁用”。
