editor.foldlevel 控制启动时默认折叠层级，数值越大折叠越深；仅对支持语义折叠的语言（如ts/python/go）首次加载生效，不影响快捷键，region标记是绕过语言限制的可靠方案。
editor.foldLevel 控制的是“启动时默认折叠到第几层”，不是“展开到第几层”
很多人误以为 editor.foldLevel 是设置“默认展开深度”，其实它干的是相反的事：数值越大，启动时折叠得越狠。设为 1 表示只展开顶层结构（比如类、函数声明），内部所有块全收起；设为 0 才是完全不折叠——但注意，这不等于“全部展开”，而是交由语言服务决定初始状态。
这个配置只在文件首次加载时生效，且仅对支持语义折叠的语言有效（如 TypeScript、Python、Go）。对 JSON 或纯文本文件，即使设了 editor.foldLevel，也不会有实际效果，因为它们没有语法层级可识别。
-
editor.foldLevel是全局设置，不能按语言单独配置（除非用[javascript]等语言专属设置块） - 值必须是整数，常见取值范围是
0（不折叠）、1（只留骨架）、2（再收一层，如函数体内的 if 块也收起） - 它不影响快捷键行为，
Ctrl+K Ctrl+0仍会强制折叠全部，不受此值限制
想让某类代码“默认展开”，得靠语言扩展的 foldingProvider 能力
VS Code 自身不决定“哪些块该展开”，而是把这件事交给语言扩展提供的 foldingProvider。比如 TypeScript 官方扩展默认会对 function、class、if 块提供折叠点，但不会自动展开它们——展开动作始终是用户触发的（点击箭头或快捷键）。
所以，如果你发现某个 if 块在打开文件后总是收着，不是配置没生效，而是该语言扩展根本没把它标记为“可展开的默认层级”。这种行为无法通过 settings.json 统一扭转，只能看对应语言扩展是否支持自定义折叠策略。
- 检查当前文件的语言模式：右下角状态栏点开，确认是
TypeScript而不是Plain Text - 某些语言（如 Python）依赖
python.foldingStrategy设置，设为"auto"才启用语义折叠，设为"indentation"后editor.foldLevel就基本失效 - 第三方语言扩展（如 Rust、Lua）可能未实现完整的
foldingProvider，导致editor.foldLevel完全不起作用
region 标记是唯一能绕过语言限制、强制控制默认展开状态的方式
当语义折叠不可靠或不够灵活时，// #region 和 // #endregion 是最可控的方案。VS Code 原生支持这类标记，且它们的折叠状态会受 editor.foldLevel 影响——也就是说，你可以用 foldLevel: 1 让所有 region 默认展开，同时保持函数体收起。
注意：#region 不是注释，是编辑器识别的指令。它在 TypeScript/JavaScript/C# 中直接生效，在 Python 中需确保 python.foldingStrategy 为 "auto" 或启用相关插件支持。
- 光标放空行 →
Ctrl+Shift+P→ 输入Fold Region→ 回车，自动生成带描述的 region 块 - region 内部嵌套 region 时，
editor.foldLevel会逐层应用，比如设为2，外层 region 展开，内层 region 收起 - HTML/CSS 文件不支持
#region，但可用<!-- #region -->和<!-- #endregion -->（部分插件支持）
别指望 editor.foldingStrategy: "indentation" 能替代语义折叠
把 editor.foldingStrategy 设成 "indentation" 看似简单粗暴，实则风险很大：它只看缩进空格数，不管语法是否合法。结果就是，一个错位的 print() 可能被当成独立折叠块，而真正的 for 循环反而被忽略。
尤其在 Python 项目中，有人为了“统一折叠逻辑”强行切到缩进模式，结果 editor.foldLevel 失效、region 标记不响应、甚至折叠图标错位——这不是 bug，是设计使然。语义折叠和缩进折叠互斥，不能混用。
- JS/TS/Go 等语言必须用
"auto"，否则function、class块根本不会生成折叠点 -
"indentation"仅适合无语法服务的场景，比如手写 Markdown 的代码块预览，或调试临时脚本 - 一旦设为
"indentation"，editor.foldLevel仍生效，但含义变成“缩进大于 N 级的块默认收起”，和语义层级无关
真正麻烦的不是调哪个参数，而是 VS Code 把折叠状态当作瞬时 UI 行为来管理——它不记录你上次展开的是哪几行，只记住光标位置和语言上下文。所以任何“默认展开”的效果，本质都是在语言服务加载后，靠规则推导出的初始渲染状态，而不是记忆用户操作。
