vscode折叠层级由语言服务解析的语法结构嵌套深度决定，而非缩进格数；默认采用"auto"策略，按ast语义节点（如def、class、if）划分层级，缩进仅在设为"indentation"时生效。
折叠层级怎么算？不是缩进几格就几层
VSCode 的折叠层级不是简单按空格或 Tab 数计算，而是依赖语言服务解析出的语法结构嵌套深度。比如一个 if 块里嵌套了 for，再包了一层 function，那这三者各自构成独立可折叠节点，但展开/折叠操作默认只作用于当前光标所在节点，不会自动连带其子节点。
常见误解是“缩进深=折叠层数多”，实际 Python 设为 editor.foldingStrategy: "indentation" 时才会按缩进算层，但此时会丢失函数名点击收起的能力；而设为 "auto"（默认）时，折叠层级由 AST 中的语义节点决定，def、class、if 各自算一层，与缩进无关。
- 光标落在
def foo():行，按Ctrl+Shift+[折叠的是整个函数体，不是只折第一层缩进 - 光标落在
if x > 0:行，折叠的是该if块，不包括外层函数 - JSX 中
{}内联表达式默认不可折叠——它不是独立语法节点，只是表达式求值位置
为什么 Ctrl+K 0 / J 不按预期折叠全部？
Ctrl+K Ctrl+0（折叠全部）和 Ctrl+K Ctrl+J（展开全部）操作的是当前文档中所有「已识别为可折叠节点」的区域，但前提是这些节点必须被语言服务成功标记。如果某段代码没被识别，就不会出现在折叠列表里。
典型失效场景：
- 文件语言模式错误：右下角显示
Plain Text而非Python，折叠功能完全静默 - TSX/JSX 文件中，
<div>{items.map(...)} 这类 <code>{}不被视为块级结构，需插件（如Auto Import或启用html.suggest.html5: false）辅助识别 - Go 文件里
//go:region注释生效，但//region（少 go:）不会触发折叠 - JavaScript/TypeScript：
// #region 初始化配置+// #endregion - Python：
# region 数据处理逻辑+# endregion - Go：
//go:region Auth Flow+//go:endregion - 装扩展
Restore Folding State（轻量，无副作用） - 在
settings.json中加"workbench.editor.restoreViewState": true，但它影响所有编辑器状态（含滚动位置、光标），不单为折叠服务
手动创建嵌套折叠区：用注释标记比改缩进更可靠
当逻辑块不属于标准语法结构（比如一长串 mock 数据、重复的 console.log、配置对象），靠语言服务自动识别基本没戏。这时用 VSCode 原生支持的区域注释最直接。
不同语言写法略有差异，但核心是成对出现：
注意：#region 必须独占一行，前后不能有其他代码；命名建议用英文短语，避免空格或特殊字符；嵌套使用时，VSCode 支持逐层折叠，但不会自动高亮嵌套关系。
折叠状态不保存？那是默认行为，不是 bug
VSCode 默认不持久化折叠状态——关掉文件再打开，一切恢复展开。这不是缺陷，而是设计选择：避免因状态残留导致协作时视图错乱。
若真需要记住折叠状态，有两个务实路径：
别碰 editor.foldingHighlight 来“假装记住”——它只高亮当前折叠范围，不保存状态，且开启后可能干扰括号匹配提示。
