VSCode默认不保存折叠状态，关闭再打开即全展开；持久化需设"editor.restoreViewState": true或用#region注释，但后者仅保结构不保展开态。
折叠状态默认不保留，关掉再打开就全展开了
VSCode 默认不会记住你上次折叠了哪些区域——哪怕只关一下文件标签页，重新打开时所有代码块都会恢复展开。这不是 bug，而是设计如此：折叠状态属于“会话级临时视图”，不写入文件或配置。
真正能持久化折叠状态的，只有两种方式：
-
editor.restoreViewState设为true（推荐）：它会让 VSCode 在重新打开**同一文件**时，恢复你上次关闭前的折叠/展开状态，包括光标位置、滚动偏移和折叠层级 - 手动加
#region注释块：这类自定义折叠区一旦创建，只要语言扩展支持（如 JS/TS/Python 官方扩展），重启后依然可折叠，但不会“自动恢复展开状态”，只是结构还在
注意：editor.restoreViewState 对多标签页、多窗口、远程开发（SSH/Dev Containers）场景也生效，但不跨工作区——换一个 .code-workspace 就不算“同一文件上下文”。
为什么 editor.restoreViewState 有时不起作用
常见现象是开了设置却还是重置折叠状态，根本原因通常是语言扩展没正确提供 foldingProvider，或者文件被识别为错误的语言模式。
排查步骤：
- 确认右下角状态栏显示的是
JavaScript、Python等，而不是Plain Text或Unknown - 在命令面板运行
Developer: Toggle Developer Tools，切换到 Console 标签，打开文件后执行console.log(monaco.editor.getLanguages())，看对应语言是否注册了foldingProvider - 检查是否安装了冲突插件（比如某些格式化插件会覆盖语言服务），临时禁用非必要扩展再测试
特别提醒：editor.restoreViewState 不影响快捷键 Ctrl+K Ctrl+0 的行为——它只管“你手动折叠过什么”，不管“你按过几次全折叠”。
Python 文件折叠状态难保持的特殊原因
Python 的折叠行为高度依赖 editor.foldingStrategy 设置，而这个设置直接影响 restoreViewState 是否能捕获函数级折叠。
默认 "auto" 模式下，Python 扩展只对 class 和模块级 if __name__ == "__main__" 提供语义折叠；普通 def 函数靠缩进识别，但 VSCode 不保证每次都能稳定提取 AST 节点，导致折叠状态无法被记录。
解决办法很直接：
- 在
settings.json中设"editor.foldingStrategy": "indentation" - 确保 Python 扩展已启用（如
ms-python.python）且版本 ≥ 2026.3 - 避免混用空格与 Tab 缩进——缩进不一致时，
indentation策略会直接放弃折叠识别
设成 indentation 后，VSCode 会把每一级缩进都当作潜在折叠单元，虽然失去函数名点击收起的语义便利，但折叠状态稳定性显著提升。
折叠后展开箭头消失？那是折叠控件被隐藏了
行号左侧没出现 ▶ 或 ▼ 图标，不是折叠功能坏了，而是 editor.showFoldingControls 被设成了 mouseover（默认值）或 never。
必须设为 always 才能始终看到折叠控件，否则鼠标不悬停就看不到图标，自然无法点击操作：
{
"editor.showFoldingControls": "always"
}
这个设置不影响快捷键，但影响鼠标操作的可见性。很多人以为“没图标=不能折叠”，其实是控件藏起来了。
复杂点在于：即使设了 always，如果某段代码被语言扩展判定为“不可折叠”（比如 JSX 中未包裹在 {} 里的表达式、TypeScript 的 interface 声明），图标照样不会出现——这时得靠 #region 或换插件补足支持。
