PAYATHON 2026

如何让 VS Code 设置恢复在主窗口标签页中打开?

社区小冯

将 workbench.editor.useModal 设为 "off",即可关闭模态编辑器,让设置重新在主窗口的普通标签页中打开。该取值见 VS Code 官方界面文档。

为什么设置会显示在原窗口上方?

这一现象与 VS Code 的模态编辑器(Modal editors)行为一致:设置等配置界面会以居中浮层的形式显示在编辑区上方。由于原问题没有提供版本号,无法仅凭描述确定这一变化由哪次更新引入。

官方文档列出了 workbench.editor.useModal 的三个取值:

  • "off":编辑器始终以普通标签页打开。
  • "some":部分配置编辑器以模态浮层打开。
  • "all":所有编辑器以模态浮层打开。

具体行为可查阅 Modal editors 配置说明。

在设置界面中关闭

  1. 打开 VS Code 设置,切换到用户设置(User)。
  2. 在设置搜索框中输入 @id:workbench.editor.useModal。
  3. 将 Workbench › Editor: Use Modal 改为 off。
  4. 关闭已打开的设置浮层,再重新打开设置,确认是否恢复为普通标签页。

直接修改 settings.json

打开命令面板:Windows/Linux 使用 Ctrl+Shift+P,macOS 使用 Cmd+Shift+P。执行 Preferences: Open User Settings (JSON),添加或修改以下配置:

{
  "workbench.editor.useModal": "off"
}

如果文件中已有其他配置,将这一项合并到现有对象中,并注意保留正确的逗号。如果同名配置已存在,直接修改原来的值。

JSON 设置仍在浮层中怎么办?

保存后先关闭原有浮层,再从主窗口的命令面板执行 Preferences: Open User Settings (JSON),以免继续沿用浮层中的打开位置。官方设置文档说明,直接打开 Settings JSON 文件时,它会显示为主窗口中的普通编辑器标签页,参见 设置编辑器说明。

如果配置项不存在,或 "off" 被提示为无效值,先确认当前 VS Code 的具体版本以及该配置项支持的取值。如果弹出的是带独立系统标题栏的窗口,还需进一步确认它是否属于浮动窗口。仅凭原问题的描述,无法确定所有窗口行为都由模态编辑器引起。

备注:内容仅供参考。