VSCode默认不保存折叠状态，需设editor.foldingStrategy为auto以启用语言服务器语义识别，配合#region标记和插件实现稳定多级折叠。
VSCode 默认不保存折叠状态，每次打开文件都会重置为全展开——这是万行代码文件里最让人抓狂的细节。要实现真正可用的多级折叠管理，关键不在“怎么折”，而在“怎么让折叠结构稳定、可预期、不跳变”。
为什么 editor.foldingStrategy 必须设为 auto
默认的 indentation 策略只看缩进，对 Go、Rust、TypeScript 这类靠大括号或关键字界定作用域的语言极不友好：函数体可能被错误切开，if 块和其内部 for 可能被当成同一级，导致折叠后逻辑断裂。
-
auto模式依赖语言服务器（如 TypeScript Server、gopls）解析 AST，能准确识别函数、类、模块、注释块等语义单元 - 必须确认右下角语言模式正确（例如显示
TypeScript而非Plain Text），否则auto退化为indentation - 某些语言（如 Python）在复杂 docstring 或装饰器嵌套时仍会误判，此时需配合手动
// #region
用 // #region 手动定义折叠边界的真实限制
它不是万能胶——VSCode 对 // #region 的支持因语言而异，且有硬性嵌套规则：
- 仅 JavaScript/TypeScript/CSS/HTML 原生支持；Python、Go、Rust 需安装对应扩展（如
Python扩展 v2026.4+ 才支持#region） - 不允许跨函数、跨 class 嵌套：不能在一个函数内开
// #region，却在另一个函数里关它 - 标题长度超过 50 字符会被截断，且不参与折叠逻辑判断，纯属视觉提示
- 示例有效写法：
// #region API handlers function getUser() { /* ... */ } function updateUser() { /* ... */ } // #endregion
Ctrl+K Ctrl+1 到 Ctrl+K Ctrl+7 折叠层级的实际含义
这不是“折叠第 1 层代码”，而是“保留第 N 层结构，折叠其内部所有内容”。不同语言的“层”定义完全不同：
- TypeScript 中：
Ctrl+K Ctrl+1通常保留import和顶层const/function/class声明，折叠所有函数体 - Python 中（缩进策略下）：
Ctrl+K Ctrl+2可能只保留模块级变量和def，但不会折叠if或for块，除非它们是顶层缩进 - JSON 文件中：
Ctrl+K Ctrl+1折叠整个对象，Ctrl+K Ctrl+2折叠第一层 key-value，Ctrl+K Ctrl+3折叠第二层嵌套对象 - 层级数上限由
editor.foldingMaximumRegions控制，默认 5000，极少需要调高
折叠状态无法持久化的根本原因与临时解法
VSCode 核心机制决定：折叠状态属于编辑器会话内存，不写入文件也不同步到工作区设置。这意味着：
- 关闭再打开文件 → 全部展开
- 重启 VSCode → 所有折叠丢失
- 即使开了
files.autoSave，也无济于事 - 目前唯一可靠方案是安装插件，如
Fold Plus（轻量）或Save and Restore Folding State（支持工作区级记忆） - 注意：插件恢复的折叠位置可能和语言服务更新后的 AST 节点偏移不一致，首次加载时偶有错位
真正的多级折叠管理，本质是结构设计问题——// #region 是补丁，foldingStrategy: auto 是基础，而折叠状态持久化是刚需。别指望靠快捷键堆出清晰结构，先拆函数、分模块、删重复逻辑，折叠才真正有用。
