必须同时关闭workbench.editor.enablePreview和workbench.editor.reuseEditors才能彻底解决单击覆盖问题:前者禁用预览模式使单击直接打开常驻标签,后者禁用复用逻辑防止双击或命令打开时覆盖已有标签。

单击文件就覆盖当前标签,不是操作失误,是 VSCode 默认启用预览模式(workbench.editor.enablePreview)+ 编辑器复用(workbench.editor.reuseEditors)共同导致的。关掉其中一个只能缓解,两个都关才能稳定新开常驻标签页。
为什么单击文件会覆盖当前标签页
VSCode 的“单击 = 预览”是明确设计行为,不是 bug。触发后会生成一个斜体、无关闭 ×、左下角标“预览”的临时标签页。这个标签本质是占位符,后续任何单击都会复用它——视觉上像“覆盖”,实际是内容替换,原文件仍在后台未关闭。
-
workbench.editor.enablePreview控制是否启用预览模式;设为false后,所有单击都直接打开常驻标签 -
workbench.editor.reuseEditors控制是否复用已有编辑器实例;设为false可避免同一文件被反复复用(比如多次点击同一个index.tsx) - 预览标签不会出现在
Ctrl+Tab的 MRU 列表里,也不响应Ctrl+Shift+P → Show All Editors的“转正”逻辑 - 双击预览标签、或按
Ctrl+K Enter(Win/Linux)可让它立刻变成常驻标签
如何让单击文件直接打开常驻标签页
最干净的解法是禁用预览模式,一劳永逸切断“预览→覆盖”链路:
- 打开设置:
Ctrl+,(Win/Linux)或Cmd+,(macOS) - 搜索
workbench.editor.enablePreview,取消勾选;或在settings.json中添加:"workbench.editor.enablePreview": false - 保存后立即生效,无需重启;但已存在的斜体标签不会自动转正,需手动双击或
Ctrl+K Enter - 此设置不影响
Ctrl+Click跳转定义(它强制在原标签内打开),也不影响右键菜单里的Open to the Side
固定标签页和防误关的关键配置
即使关了预览,固定(Pin)标签仍需手动操作,且默认不持久——重启即丢失。想减少意外关闭,要额外调整几项:
- 固定单个标签:右键标签页 →
Keep Open(部分版本显示为Pin Tab),或点击左侧图钉图标;快捷键Ctrl+K Enter - 禁用鼠标中键关闭:
"workbench.editor.mouseBackForwardToNavigate": false(否则滚轮按下会直接关掉当前标签) - 确保没启用编辑器组限制:
"workbench.editor.limit.enabled": false,否则Keep Open可能被强制忽略 - 开启跳转已有标签:
"workbench.editor.revealIfOpen": true,避免重复打开同一文件导致混乱
同名文件区分与路径显示问题
预览模式下,多个 index.tsx 会互相覆盖,连文件路径都看不到。关掉 workbench.editor.enablePreview 是前提,再配合:
- 设置
"editor.labelFormat": "medium"或"long",让标签页显示路径片段或完整路径 - macOS 用户还需禁用
"window.nativeTabs": false和"window.nativeFullScreen": false,否则标签页样式受限,路径无法正常渲染 -
workbench.editor.showTabs必须为true(默认开启),否则标签栏本身就不显示
真正麻烦的不是关开关,而是关完之后那些已经斜体的旧标签——它们不会自动变正,得一个个手动处理;更隐蔽的是,workbench.editor.reuseEditors 这个配置很多人根本没注意到,但它在多文件频繁切换时会悄悄干扰“新开”逻辑。











