<p>Python中// #region不生效，因其注释语法为#而非//，VSCode的Python扩展仅识别# region和# endregion作为折叠指令。</p>
为什么 // #region 在 Python 里不生效
Python 文件里写 // #region 永远不会折叠，因为 Python 的注释是 #，不是 //。VSCode 的 Python 扩展（ms-python.python）只识别 # region 和 # endregion 作为折叠指令。
- 正确写法：
# region 数据预处理（独占一行，前面不能有空格，后面可跟描述） - 错误写法：
// #region、#region（缺空格）、# region后面紧跟代码（如# region utils; x = 1） - 混用
// #region和# region会导致整个文件折叠逻辑紊乱，可能只折第一行或完全失效
JS/TS/C# 中 #region 折叠失败的常见原因
这些语言原生支持 // #region，但失效往往不是语法问题，而是环境配置或书写细节偏差。
- 语言模式必须正确：右下角显示的是
TypeScript，不是TypeScript React或Plain Text；后缀名也要匹配（.ts，不是.txt） -
// #region必须独占一行，且//后紧跟一个空格 +#region，不能是//#region或// #region（多余空格也不行） -
// #endregion同理，不能带任何其他字符，包括尾部空格、分号、注释说明 - 嵌套时配对必须严格：外层
// #region A→ 内层// #region B→// #endregion→// #endregion；错位或漏写会破坏所有嵌套层级
折叠状态为什么每次打开文件都重置
VSCode 默认不保存折叠状态——这不是 bug，是设计行为。关掉再打开，它会重新根据语言服务解析结构，从头计算初始折叠层级。
- 想持久化？得装扩展，比如
Restore Code Folding，或手动在设置里加"editor.restoreViewState": true（仅对部分语言和折叠方式有效） - 大纲视图（Outline）里看到的折叠节点，和编辑器内实际折叠状态不一定同步；右键“折叠全部”只作用于当前可见区域，不是整个文件
- 折叠后光标定位会受影响：跳转到某函数定义时，如果该函数被折叠，光标会停在折叠标题行，而不是函数体内部
不用 #region 也能折叠？试试 foldingStrategy
当代码没大括号、没缩进结构（比如 JSON 配置块、YAML 片段、长段 Markdown 注释），#region 是唯一可靠手段；但对 Python、HTML 等依赖缩进的语言，可以换策略。
- 临时启用缩进折叠：
"editor.foldingStrategy": "indentation"（设在用户设置或工作区设置中），适合纯缩进驱动的语言 - 禁用某语言自动折叠：比如 JSON 文件默认按大括号折叠，但你只想看顶层字段，可设
"json.folding": false - 注意冲突：同时开启
indentation和#region标记，VSCode 优先使用语言服务提供的折叠提供者（foldingProvider），可能忽略你的注释标记
复杂点在于：同一份代码，在不同语言模式下，折叠行为可能完全相反；而最易被忽略的，是右下角那个小小语言标识——它一错，所有折叠逻辑就归零。
