vscode 1.84+ 才原生支持多行标签页，需配置 "workbench.editor.wraptabs": true，旧版本无效；注意工作区设置、扩展干扰及标签渲染特性。
VSCode 1.84+ 版本才能真正实现多行 Tab 标签页自动换行，旧版本无论怎么配都只是视觉模拟，不是原生支持。
确认你用的是 VSCode ≥ 1.84
这不是设置问题，而是版本门槛。低于 1.84（比如 1.83）压根不识别 workbench.editor.wrapTabs，改了 settings.json 也无效。
- 打开命令面板：
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS） - 输入并运行
Help: About，看右上角显示的版本号 - 远程开发（SSH / WSL）场景下，必须同时检查远程端 VSCode Server 版本——以远程端为准
启用原生多行标签页的正确配置
必须写进 settings.json，UI 设置里搜 “wrap tabs” 勾选后底层其实也是写这行，但手动编辑更可控、不易被覆盖。
- 打开设置 JSON：
Ctrl+,→ 右上角「打开设置 (JSON)」 - 添加这一行（注意逗号分隔）：
"workbench.editor.wrapTabs": true - 拼写不能错：
wrapTabs不是wrapTab、multiLineTabs或tabWrap - 值必须是布尔型
true，不是字符串"true"或数字1
开了还是单行？先排查这三类干扰
常见“设了没反应”，90% 是被更高优先级策略或环境干扰挡住，不是配置本身错了。
-
workbench.editor.limit.enabled为true且workbench.editor.limit.value设得太小（如 10），多余标签会被隐藏，而非换行 - 当前工作区
settings.json里写了"workbench.editor.wrapTabs": false—— 工作区级配置优先于用户级 - 用了
Custom CSS and JS Loader或某些 UI 主题插件，它们会直接覆盖 DOM 样式，让原生换行失效；临时禁用所有扩展验证
换行后看起来“错位”或“文字截断”，这是正常渲染副作用
VSCode 的多行标签栏不是网格布局，而是 flex 自动折行，所以：
- 第二行标签不会自动对齐第一行底部，视觉上可能“浮高”——这不是 bug，是当前渲染逻辑决定的
- 标签宽度仍按文件名长度动态分配，长路径（如
src/utils/helpers/string/normalize-utf8.ts）容易被截成.../normalize-utf8.ts，且悬停提示也不一定完整显示 - 如果之前用过
workbench.editor.tabHeight自定义高度，换行后上下行可能错开；建议保持默认值，避免手动干预
最常被忽略的一点：多行标签页只是把标签“堆高”，并没有降低操作成本。当你打开 20+ 个文件时，滚动找标签、误点相邻 tab、视觉疲劳等问题依然存在——它解决的是“看不见”，不是“不好找”。
