<p>VSCode中用// #region折叠代码需语言模式支持：JavaScript/TS默认可用，Python须用# region，Go不支持；自定义语言需在language-configuration.json配置foldingStartMarker等正则规则。</p>
怎么在 VSCode 里用 // #region 折叠自定义代码块
VSCode 默认支持用 // #region 和 // #endregion 标记手动折叠区域，但前提是语言模式得识别它。不是所有语言都开箱即用——比如 JavaScript/TypeScript 默认支持，Python 默认不支持，Go 完全不识别。
实操建议：
- 确保当前文件的语言模式正确（右下角显示如
JavaScript，不是Plain Text） - 写法必须严格：开头是
//（双斜杠），后面紧跟空格 +#region，不能写成//#region或/* #region */ - 可选标题：写成
// #region 初始化逻辑，折叠后会显示“初始化逻辑”，比默认的“#region”更直观 - 嵌套有效：
// #region可以多层嵌套，VSCode 会按缩进和配对关系处理，但别嵌太深，容易误折叠
Python 文件里 // #region 不生效？该换 # region
Python 默认注释是 #，VSCode 的 Python 扩展（ms-python.python）把 # region 和 # endregion 当作折叠指令，而不是 // #region。混用会导致完全不折叠，或只折叠第一行。
常见错误现象：
- 写了
// #region，右键“折叠区域”没反应，快捷键Ctrl+Shift+[也无效 - 写了
# region但前面多了空格或拼错成#region（缺空格），同样失效
实操建议：
- Python 用
# region和# endregion（注意#后必须跟空格） - 确认已安装并启用官方 Python 扩展；禁用其他可能干扰折叠的插件（如某些旧版 linter）
- 如果仍不生效，在设置里搜
python folding，检查python.foldingStrategy是不是设成了indentation（应为language-defined）
Ctrl+Shift+[ 折不了？检查折叠级别和光标位置
快捷键失效不一定是配置问题，更多是触发条件没满足：VSCode 折叠依赖光标是否落在可折叠区域内，且该区域未被更高优先级的折叠规则覆盖（比如函数体折叠优先级高于 #region）。
使用场景：
- 光标在
// #region行 → 按Ctrl+Shift+[折叠整个区域 - 光标在区域内部任意行 → 同样能折，但若该行本身属于一个函数，可能先触发函数折叠
- 想快速展开所有：用
Ctrl+K Ctrl+0（数字零），不是字母 O
容易踩的坑：
- 文件太大（>10MB）时，VSCode 会自动禁用部分折叠功能，控制台报错
Folding is disabled due to large file size - 某些语言扩展（如 Vue 的 Volar）会接管折叠逻辑，导致
#region被忽略，此时需在设置中关闭volar.experimental.templateFolding
自定义语言里想加 #region 支持？改 language-configuration.json
如果你在写 DSL、配置文件或小众语言，VSCode 默认不认识 #region。这时候不能靠插件硬塞，得在语言配置里声明折叠标记——否则编辑器连“这是个可折叠块”都不知道。
参数差异：
-
foldingStartMarker设为正则，如"^\s*#\s*region"（匹配以任意空格开头、接着#、空格、region的行） -
foldingStopMarker对应"^\s*#\s*endregion" - 注意转义：JSON 里反斜杠要写两道
\，正则实际生效的是单个
性能影响：
- 正则越复杂，大文件滚动时折叠计算越慢；避免用
.*开头或无边界锚点 - 如果语言本身有花括号块（如 JSON5），优先用
indentation策略，比正则更稳
region 折叠看着简单，真正卡住人的往往是语言模式没对上、注释符号写错类型、或者被某个扩展悄悄覆盖了行为。调不出来的时候，先看右下角语言标识，再打开命令面板搜 Fold 看有哪些折叠命令可用，比翻设置快得多。
