vscode默认不保留折叠状态,需同时启用workbench.editor.restoreviewstate和editor.restoreviewstate,并确保语言识别正确及扩展提供稳定折叠支持。

折叠状态默认不保留,关文件就重置
VSCode 默认不会记住你上次折叠了哪些区域——每次重新打开文件,所有代码都会恢复展开状态。这不是 bug,是设计如此。它只在当前编辑器会话中维持折叠状态,一旦关闭文件标签页、重启 VSCode 或切换到其他工作区,折叠信息就清空了。
靠 editor.restoreViewState 恢复折叠状态
这个设置控制“是否在重新打开同一文件时还原视图状态(包括折叠、滚动位置、光标位置)”。它默认为 true,但实际生效需满足两个前提:
- 文件必须被 VSCode 正确识别为对应语言(右下角显示
JavaScript、Python等,不能是Plain Text) - 语言扩展必须提供稳定的折叠提供者(比如官方 Python 扩展、TypeScript 官方支持;某些轻量插件或自定义语法可能不实现该能力)
验证方式:打开一个 .ts 文件 → 折叠几个函数 → 关闭标签页 → 再次打开该文件,看是否自动恢复折叠。若不恢复,先检查语言模式和扩展状态。
workbench.editor.restoreViewState 是全局开关
这个配置项才是真正启用/禁用“所有编辑器视图状态恢复”的总控开关。它影响折叠、滚动、光标、选区等全部状态。如果设为 false,即使 editor.restoreViewState 为 true 也无效。
常见误操作:有人只改了 editor.restoreViewState 却没确认 workbench.editor.restoreViewState 是否开启,结果发现折叠记忆始终不生效。
推荐设置(写入 settings.json):
{
"workbench.editor.restoreViewState": true,
"editor.restoreViewState": true
}
真正难调的不是设置,是语言扩展的实现粒度
即使上述两项都开了,某些语言仍无法恢复折叠,原因在于:折叠状态依赖语言扩展提供的 FoldingProvider 是否稳定返回一致的折叠范围。例如:
- JSX 中的
{}表达式能否被识别为可折叠单元,取决于 Prettier 或 ESLint 插件是否干扰了折叠提供链 - Python 的三引号文档字符串是否被折叠,取决于
python.foldingStrategy是否为indentation且缩进层级未被格式化工具破坏 - 自定义
// #region标记能否跨会话保留,要求语言服务在初始化阶段就完成区域扫描——而部分扩展延迟加载会导致首次打开时漏掉
遇到恢复失败时,优先重载窗口(Ctrl+Shift+P → Developer: Reload Window),再测试。比反复调设置更有效。











