TagsViewConfig是GitLens扩展中控制标签视图行为的TypeScript接口，定义在src/config.ts中，继承自ViewsCommonConfig，仅影响GitLens侧边栏的Git标签列表展示（如头像开关、分支/文件布局、自动聚焦等），不涉及VSCode原生文件标签页。
TagsViewConfig 是什么，它管哪些事
TagsViewConfig 不是 VSCode 原生配置，而是 GitLens 扩展中控制「标签视图」（即 Git 标签列表）行为的 TypeScript 接口。它定义在 GitLens 源码的 src/config.ts 中，继承自通用视图配置，但只影响 GitLens 的标签面板——和 VSCode 自身的文件标签页（tab）完全无关。
常见误操作是把它和 workbench.editor.* 或 editor.labelFormat 混为一谈。你改了 TagsViewConfig.avatars，顶多让 GitLens 标签列表里是否显示提交者头像；对 Ctrl+Tab 切文件、标签栏路径显示、预览态行为，一点影响都没有。
-
avatars: boolean：开关头像，纯 UI，不影响功能 -
branches.layout：决定 GitLens 标签视图里分支是“列表”还是“树形”，仅作用于 GitLens 的侧边栏标签面板 -
files.layout：控制该标签关联的文件是以“自动”“列表”还是“树形”展开，同样只出现在 GitLens 视图里 -
reveal：切换仓库时是否自动把焦点切到 GitLens 的标签视图 —— 仅对 GitLens 生效，不触发 VSCode 文件跳转
怎么改 TagsViewConfig？不是 settings.json
GitLens 的 TagsViewConfig 不能通过 VSCode 设置界面或 settings.json 直接编辑。它是扩展内部的运行时配置，修改方式只有两种：
- 在 GitLens 设置页面搜 “tags view”，找到对应开关项（如 “Show Avatars in Tags View”），勾选/取消即可 —— 这会间接写入
gitlens.views.tags.avatars这类扩展专属配置项 - 手动编辑
settings.json，添加类似"gitlens.views.tags.branches.layout": "tree"的键值对，值必须严格匹配 GitLens 文档定义的枚举（"list"或"tree"）
注意：gitlens.views.tags.* 配置项只被 GitLens 读取，VSCode 核心不识别它们。填错值（比如写成 "grid"）不会报错，但会被静默忽略。
为什么改了没反应？常见断点位置
改完 gitlens.views.tags.* 配置后标签视图没变化，大概率卡在这几个地方：
- GitLens 标签视图根本没打开：按
Ctrl+Shift+P→ 输入GitLens: Toggle Tags View确保面板已激活 - 当前仓库没有 tag：运行
git tag确认有输出；空仓库或未打过 tag 的分支下，视图永远为空 - 视图被折叠：GitLens 侧边栏里标签视图可能被收起，点顶部小图标（通常是
#或?）才能展开 - 配置写在了错误的作用域：比如加到了用户级
settings.json，但你用的是多根工作区，需要加到工作区级设置里才生效
还有一个容易被忽略的点：TagsViewConfig 的变更**不需要重启 VSCode，但必须重新打开 GitLens 标签视图**（关掉再 toggle 一次），否则缓存可能让旧布局继续显示。
别指望它解决文件标签页问题
如果你真正想调的是「文件 tab 怎么切换」「同名文件怎么区分」「路径怎么显示在标签栏」，TagsViewConfig 完全不相关。那些属于 VSCode 核心编辑器行为，要动的是这些配置：
-
workbench.editor.enablePreview：关掉它，所有新打开文件都变固定态，Ctrl+1~9和Ctrl+PageUp才能稳定工作 -
editor.labelFormat：设为"medium"或"long"，配合关闭预览模式，才能让顶部标签栏显示路径 -
workbench.action.showAllEditors：这是唯一能列出当前窗口全部文件（含预览态）的原生命令，别指望 GitLens 的标签视图替代它
GitLens 的 TagsViewConfig 只管 Git 标签元数据的展示逻辑，不是文件导航工具。混淆这两层，是调试失败最常发生的起点。
