VS Code代码折叠依赖语言支持、语法识别和用户控制；默认开启但常因语言模式错误或配置不当失效，需检查语言标识、foldingStrategy设置及#region注释格式。
VS Code 的代码折叠不是靠记忆快捷键就能用好的功能，它依赖语言支持、语法结构识别和用户对折叠区域的主动控制。默认开启，但很多开发者根本没意识到它被禁用了，或误以为“没反应”就是不支持。
为什么有些代码块无法折叠？
折叠能力由当前文件的语言模式（Language Mode）决定，不是所有语言都开箱即用：
-
JSON、YAML、Markdown默认支持基于缩进或结构的折叠 -
Python依赖indentation（缩进），但函数/类定义需有明确冒号+换行，空行或注释可能打断识别 -
JavaScript/TypeScript支持function、if、{}块、import区块等，但箭头函数体若为单表达式（如() => console.log(1)）不会被折叠 -
HTML按标签层级折叠，但自闭合标签（如 - 如果
settings.json中设置了"editor.foldingStrategy": "auto"却仍无效，大概率是语言服务器未加载或文件后缀未关联正确语言模式
常用折叠操作与快捷键（跨平台）
别只记 Ctrl/Cmd + Shift + [ ]，真正高效的是组合使用：
- 折叠光标所在区域：
Ctrl+Shift+[（Windows/Linux）或Cmd+Shift+[（macOS） - 展开光标所在区域：
Ctrl+Shift+]或Cmd+Shift+] - 折叠全部：
Ctrl+K Ctrl+0（数字零，不是字母 O） - 展开全部：
Ctrl+K Ctrl+J - 折叠到指定层级（比如只看函数名）：
Ctrl+K Ctrl+1~Ctrl+K Ctrl+5，数字代表折叠深度 - 鼠标悬停在编辑器左侧折叠指示条（gutter）上，出现「▶」时点击即可手动折叠该块
如何让自定义区块也能折叠？
VS Code 支持用特殊注释标记折叠区域，适用于配置文件、脚本或不被原生支持的语言：
- 在注释中写
// #region开始，// #endregion结束（JS/TS/Python 等通用） - 支持带标题：
// #region 数据处理逻辑，折叠后 gutter 显示该文本 - 其他语言可用对应注释语法，如
/* #region */（CSS/HTML）、#region（Python，注意无双斜杠） - 注意：必须启用
"editor.foldingStrategy": "indentation"或"auto"，且注释格式不能有拼写错误（例如#regoin不生效）
折叠状态容易被忽略的细节
折叠不是“视觉隐藏”那么简单，它会影响部分编辑行为和插件表现：
- 搜索（
Ctrl+F）默认跳过已折叠区域的内容，除非勾选「Find in folded regions」 - 代码导航（如
Go to Symbol）仍能定位到折叠内的函数，但预览时显示的是折叠后的占位文本 - 某些 LSP 插件（如 Pylance）在深度折叠后可能延迟更新诊断信息
- 终端或调试控制台输出的栈帧位置，仍指向原始行号——折叠不改变实际代码结构
最常被卡住的地方其实是语言模式没设对：右下角状态栏点开语言标识，确认是 JavaScript 而不是 Plain Text；或者打开一个 .ts 文件却看到语言显示为 PHP，这时折叠必然失效。先校准这个，再调快捷键才真正有用。
