vscode 默认不保存折叠状态,需启用 workbench.editor.restoreviewstate: true 并确保文件已保存、语言模式正确、语言服务就绪且无插件干扰。

VSCode 默认不保存折叠状态,但可以启用 workbench.editor.restoreViewState 让它记住——前提是文件已保存、语言服务就绪、且没被插件干扰。
为什么关掉再打开,所有折叠都展开了?
这不是 bug,是 VSCode 的默认设计:它只持久化打开的文件列表、光标位置和编辑器布局,foldingState 不在默认保存范围内。每次重载文件,VSCode 都会重新计算初始折叠层级,相当于“重来一遍”。
- 未保存的文件(如
Untitled-1)完全不存折叠状态,关闭即丢 - 即使配置了
workbench.editor.restoreViewState: true,若文件语言模式错误(比如右下角显示Plain Text),语言服务器不响应textDocument/foldingRange,也就没折叠数据可存 - 某些插件(如旧版 Python 扩展、自定义语法高亮)会禁用或覆盖折叠提供器,导致 VSCode 根本不生成折叠区域
怎么开启折叠状态持久化?
关键就一条配置:workbench.editor.restoreViewState 必须为 true。现代 VSCode 默认就是 true,但容易被工作区设置、插件或旧版配置覆盖。
- 打开
settings.json(Ctrl+Shift+P →Preferences: Open Settings (JSON)),确认含这一行:"workbench.editor.restoreViewState": true
- 不要改
editor.foldingStrategy为indent——它会让函数/类级折叠退化为纯缩进识别,语义折叠信息丢失,restoreViewState就没东西可记 - 确保文件有真实路径(已保存)、语言 ID 正确(如
javascript、python),且对应语言扩展正常运行(可 Ctrl+Shift+P →Developer: Toggle Developer Tools查控制台是否有 folding 相关报错)
哪些情况折叠状态“记不住”?
不是配置开了就一定生效。折叠状态实际存在 workspace 的 SQLite 数据库里(state.vscdb),但多个条件会中断写入链路:
-
editor.folding被设为false(极少见,但某些自定义语言模式或插件会这么干) - 文件过大(>5000 行)或启用了
"editor.folding": false的语言模式,VSCode 会跳过折叠计算 - Markdown 中的
```代码块、JSON 中的非法注释、Python 三引号字符串——这些结构会让折叠解析失败,连带整个文件的状态不写入 - 多根工作区中,每个文件夹独立保存状态;跨文件夹移动文件后,原折叠状态不会迁移
验证是否真生效了
别猜,直接查。最可靠的方式是:
- 手动折叠几个函数 → 保存文件 → 关闭标签页(不是退出 VSCode)→ 重新打开该文件,看是否保持折叠
- 如果失效,打开命令面板(Ctrl+Shift+P)→ 输入
Developer: Toggle Developer Tools→ 切到 Console 标签,搜索folding或restoreViewState,看有没有警告或错误 - 检查右下角语言标识是否正确;再按 Ctrl+Shift+P →
Developer: Inspect Editor Tokens and Scopes,点一个函数名,确认languageId是预期值(如typescript),且下方有foldingRanges数据
真正容易被忽略的是:折叠状态依赖语言服务器返回的 foldingRange,而这个响应本身不稳定——TS Server 崩溃、Pylance 启动慢、项目没配 tsconfig.json,都会让“记得住”变成“记不住”。











