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

workbench.editor.limit.enabled 必须设为 true 才生效
VSCode 默认完全不限制标签页数量,workbench.editor.limit.value 单独设置毫无作用。很多人只加了 "workbench.editor.limit.value": 12,但没开总开关,结果改完 settings.json 完全没反应——这不是配置写错了,是根本没启用限制逻辑。
必须显式加上:"workbench.editor.limit.enabled": true。这个布尔值是总闸门,false 就等于没装限流阀。UI 设置界面里找不到这个选项,只能手动编辑 JSON(Cmd/Ctrl + , → 右上角打开 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 渲染性能。
如果你用 Claude Code 插件,常把对话面板固定在一侧,建议设为 true,避免 AI 面板被新文件挤掉。
为什么改了设置没生效?关键三点要一起查
VSCode 的编辑器限制逻辑只在「新标签页打开时」触发,不是后台常驻监控。所以改完设置不会立刻关掉已有标签,要等下一次打开第 N+1 个文件才生效。
务必同时检查以下三项:
-
workbench.editor.limit.enabled是否为true -
workbench.editor.limit.value是否设为合理数值(非 0 或 1) -
workbench.editor.enablePreview是否为false—— 预览模式下的文件不算「已打开」,容易误判剩余名额
另外,固定标签页(右键 → Keep Open)可豁免限制,但该状态不持久,重启即丢;已固定的标签仍可能被 Ctrl+W、鼠标中键或双击空白处关闭。


















