VSCode 默认不启用基于注释的代码折叠，需手动配置语言专属 foldingStrategy 为 "auto"（如 "javascript.preferences.foldingStrategy": "auto"）以支持 #region；Markdown 标题折叠须依赖扩展如 Markdown All in One。
VSCode 默认支持代码折叠，但很多用户发现 // 注释、自定义区域或 Markdown 标题无法折叠——这不是功能缺失，而是默认只识别语法结构（如函数、类、块级大括号），不启用基于注释的折叠需手动开启。
如何开启基于注释的代码折叠（#region / // #region）
VSCode 从 1.43 版本起原生支持 #region 折叠，但默认关闭。关键配置项是 "editor.foldingStrategy" 和 "editor.showFoldingControls"，但真正启用注释折叠靠的是语言特定设置：
- 在
settings.json中添加语言专属配置，例如对 JavaScript/TypeScript 启用："javascript.preferences.foldingStrategy": "indentation"
或更推荐的："javascript.preferences.foldingStrategy": "auto"
- 对 Python，需确保安装了官方 Python 扩展，并设置：
"python.editor.foldingStrategy": "auto"
- 全局启用
// #region风格（如 VS 风格）：必须配合插件，比如Region Folder；纯 VSCode 原生只识别#region（无双斜杠）且仅限部分语言（如 C#、TS 支持较好，JS 需typescript.preferences.foldingStrategy: "auto"）
editor.foldingStrategy 的三个取值区别
这个配置决定 VSCode 怎么“找折叠边界”，不同策略影响可折叠范围和性能：
-
"auto"：优先用语言服务器提供的折叠信息（最准，但依赖扩展，如 TypeScript Server、Pylance）。对if、for、函数体等语义块识别好，也支持#region -
"indentation"：纯靠缩进判断（类似 Python 的逻辑块）。适合 Markdown、YAML、Shell 脚本等无大括号语言，但会把所有缩进层级都变成可折叠节点，可能太细碎 -
"syntax"：仅识别语法关键字（{、function、class等），最快但最保守——// #region和注释块完全不生效
Markdown 文件标题折叠为什么无效？
VSCode 对 Markdown 的折叠支持较弱，默认只折叠代码块（```）和 HTML 标签，# 标题 不折叠。解决方法有限：
- 安装扩展
Markdown All in One，它会自动为##及以下标题添加折叠标记（需开启"markdown.extension.folding.enabled": true） - 改用
indentation策略："markdown.editor.foldingStrategy": "indentation"
，此时按缩进折叠，但标题本身无缩进，仍无效——所以本质是 Markdown 折叠依赖扩展，不是配置能绕过的 - 手动加 HTML 注释模拟区域（不推荐）：
<!-- #region My Section --> ... <!-- #endregion -->
，仅在支持 HTML 的预览中可见，编辑器里不会形成折叠节点
真正影响体验的不是“能不能开折叠”，而是语言服务是否就位、foldingStrategy 是否匹配文件类型，以及对 #region 这类非标准语法的支持程度——这些细节不查文档、不看语言扩展说明，光调设置容易白忙活。
