<p>VSCode代码折叠失效主因是语言特异性配置未覆盖或折叠语法不支持；对JS/TS/Python等语言默认用syntax策略，indent被忽略；手动折叠需用#region/#endregion（Python用# region）并确保语言扩展正常。</p>
VSCode 默认支持代码折叠，但很多用户发现 foldingStrategy 不生效、自定义区域不折叠、或注释块无法收起——根本原因通常是配置未覆盖语言特异性，或误用了不被支持的折叠语法。
为什么 "editor.foldingStrategy": "indent" 有时无效
该设置仅对无原生折叠支持的语言（如纯文本、YAML）生效；对 JavaScript、Python、TypeScript 等语言，VSCode 优先使用语言服务器提供的语法级折叠（"syntax"），此时 indent 被忽略。
- 检查当前语言：打开文件后看右下角语言模式（如
JavaScript React），再执行Developer: Toggle Developer Tools查看控制台是否有foldingProvider相关报错 - 强制改用缩进折叠：在对应语言的
settings.json中加"[javascript]": {"editor.foldingStrategy": "indent"}，但会丢失函数/类等语义折叠 - 推荐保留
"syntax"，仅在特定场景（如 Markdown 中折叠大段 HTML）临时切为indent
如何用 // #region 和 // #endregion 手动标记折叠区
这是跨语言通用、且 VSCode 原生支持的显式折叠方式，比注释符号更可靠。
- JavaScript/TypeScript/CSS/HTML/Markdown 全部支持，无需插件
- 必须成对出现，且
#region后可跟描述（如// #region API handlers），#endregion可不带文字 - 注意：Python 不识别
//，需改用# region和# endregion（前面是井号+空格，不是双斜杠） - 折叠后显示文字为
region或你写的描述，鼠标悬停可预览内容
Python 中 #region 不折叠？检查语言模式和扩展冲突
VSCode 的 Python 折叠依赖 python 扩展（Microsoft 官方）提供的 foldingProvider。若手动标记不生效，大概率是扩展未启用或配置被覆盖。
- 确认已安装并启用
ms-python.python扩展（注意不是ms-python.pylint等子扩展） - 检查
settings.json是否存在"python.editor.foldingStrategy"，该配置优先级高于全局editor.foldingStrategy - 禁用其他可能干扰的扩展（如
Bracket Pair Colorizer旧版曾导致折叠渲染异常） - 重启 VSCode 并用
Ctrl+Shift+P→Folding: Toggle Fold测试单行是否可折叠，排除键盘映射问题
真正影响折叠体验的往往不是“怎么开”，而是语言服务是否就绪、区域标记是否符合当前语言规范、以及扩展之间有没有静默覆盖。尤其在多语言混合项目（如 .vue 文件含 template/script/style）中，不同区块可能由不同语言服务处理，折叠行为天然不一致——这点容易被忽略，但恰恰是调试折叠失效的第一排查点。
