VSCode 1.84+ 版本原生支持多行标签栏，需同时满足 workbench.editor.showTabs 为 true 且未启用 vertical tabs；旧版本或远程 Server 版本过低时该配置完全无效。
workbench.editor.wrapTabs 配置是否生效取决于版本和上下文
VSCode 原生支持多行标签栏（即“堆叠显示”）仅从 1.84 版本起，且必须满足两个前提：workbench.editor.showTabs 为 true，且未启用垂直标签栏（workbench.editor.vertical 为 false）。低于该版本或远程开发中 VSCode Server 版本过旧时，勾选 workbench.editor.wrapTabs 完全无效——不是配置错，是功能压根没加载。
检查方式：按 Ctrl+Shift+P 输入 Help: About，确认版本号；若用 SSH/WSL，需在远程终端执行 code --version 验证服务端版本。
- 设置路径：打开
settings.json，添加"workbench.editor.wrapTabs": true - 注意：该配置不控制“是否显示标签”，只控制“超出宽度时是否换行”。若
showTabs关闭，它会被忽略 - 常见误配：同时开启
workbench.editor.vertical和wrapTabs→ 后者被静默禁用，无报错也无效果
vertical tabs 模式才是稳定替代方案（尤其 ≥1.86）
如果你用的是 1.86+，直接关掉顶部标签栏、启用左侧垂直堆叠更可靠。这不是妥协，而是官方推荐路径：workbench.editor.showTabs 设为 false，再设 workbench.editor.vertical 为 true。此时所有标签以单列形式堆叠在编辑器左侧，天然支持无限“行数”，且不受宽度限制。
- 优势：不依赖 CSS hack、不随 VSCode 更新失效、滚动更顺滑、支持鼠标中键关闭
- 兼容性注意点：
Ctrl+Tab切换逻辑不变，但右键菜单位置偏移，GitLens 等插件的内联提示可能需更新到适配 vertical 布局的版本 - 副作用：多编辑器组（分屏）不再有独立顶部 tab 栏，所有标签统一归左——对习惯分屏独立管理的人需适应
为什么“强制换行 CSS”现在基本不可用
过去有人用 Custom CSS and JS Loader 注入 flex-wrap: wrap 强制顶部标签换行，但现在几乎必然失败。VSCode 自 1.90 起强化了样式沙箱策略，直接拦截外部 CSS 对 .tabs-container 等关键类的修改；即使临时生效，每次升级后需重签名、重载、重启，维护成本远超收益。
- 典型报错：
Refused to apply inline style because it violates the following Content Security Policy - 即便绕过 CSP（如改 host 文件、禁用安全策略），新版 DOM 结构已变更，原
.tabs-and-actions-container类名可能不存在或语义不同 - 真实代价：你花 20 分钟调试样式，不如花 2 分钟切到 vertical tabs 模式并调整快捷键习惯
真正卡住你的往往不是显示，而是 tab 数量失控
追求“多行显示”的人，十有八九实际问题是 tab 泛滥：预览页没关、Jupyter preview 自动开、Markdown 实时渲染占位、语言服务器弹出辅助 editor……这些比 UI 布局更消耗内存和注意力。
- 先做减法：
"workbench.editor.enablePreview": false关闭预览模式，双击文件才新开 tab - 加硬约束：
"workbench.editor.limit.enabled": true+"workbench.editor.limit.value": 20，超限自动关最旧 tab - 固定关键文件：
workbench.editor.pinnedTabSizing设为shrink，让 pinned tab 不抢空间 - 查干扰源：禁用非必要语言扩展（如关掉 Python 扩展的
python.defaultInterpreterPath），观察 tab 是否还莫名增加
多行或垂直堆叠只是表象，tab 管理逻辑没理清，换哪种布局都会很快再次溢出。
