必须将 workbench.editor.limit.enabled 设为 true 才启用标签页数量限制,否则 workbench.editor.limit.value 无效;该限制仅在打开第 N+1 个文件时按 LRU 策略关闭非活动、未保存的旧标签,不主动清理已有标签。

workbench.editor.limit.enabled 必须设为 true 才生效
VSCode 默认不限制标签页数量,workbench.editor.limit.value 单独设置毫无作用。很多人只改了数值却没开开关,结果改完 settings.json 完全没反应——这不是配置写错了,是根本没启用限制逻辑。
必须在 settings.json 中显式加上:"workbench.editor.limit.enabled": true
- 这个布尔值是总闸门,false 就等于没装限流阀
- UI 设置界面里找不到这个选项,只能手动编辑 JSON
- 工作区级设置(
.vscode/settings.json)会覆盖用户级设置,团队协作时建议直接写进项目里
workbench.editor.limit.value 设多少合适
这个值不是“显示几行标签”,而是整个编辑器栈中允许存在的最大编辑器实例数。超出时 VSCode 按 LRU(最近最少使用)策略关闭最久未激活的标签,但仅限于未保存、非聚焦、非锁定状态的文件。
- 设 5~8:太小,刚切走写两行的
scratch.ts可能立刻被顶掉 - 设 12~20:多数人平衡点,兼顾多文件比对和响应速度
- 设 50+:低配机器上标签栏渲染明显变慢,尤其开启多行显示后
- 已修改未保存的文件不会被关,这是安全兜底,不是 bug
workbench.editor.limit.perEditorGroup 控制分栏是否独立计数
默认 false,意味着左右两个编辑器分组共享同一个上限;设为 true 后,每组各自计数,适合并排看源码 + 测试 + 日志这类场景。
- 开启后,左栏打开 10 个、右栏再开 10 个,都不会触发关闭
- 但注意:它只影响「自动关闭」行为,不影响标签页 UI 渲染性能
- 如果你常用
Ctrl+\分栏,且经常左右对照,推荐设为true
为什么改了设置还是不关旧标签
限制逻辑只在「新文件打开瞬间」触发,不是后台常驻监控。已有标签不会被主动清理,要等你打开第 N+1 个文件时才执行关闭动作。
- 插件可能绕过限制:比如 GitLens 的
Open File on Left、调试器自动打开的debug.log,它们调用的是内部 API - 预览模式(
workbench.editor.enablePreview: true)下的文件不算“已打开”,容易误判剩余名额,建议关掉 - 确认改的是当前生效的 settings.json —— 工作区设置优先级高于用户设置,但容易被忽略
真正容易被忽略的是:VSCode 关闭依据只有 last focused time,不区分内容重要性。一个刚写三行的临时文件,可能比三天没点过的只读 README.md 更早被关掉。锁住关键文件靠手动固定(双击标签页),而不是指望自动策略识别“重要性”。


















