VSCode标题栏自定义失效最常见原因是启用了系统原生标题栏（如macOS的nativeTabs或nativeFullScreen），此时window.title被完全忽略；必须设window.titleBarStyle为"custom"、禁用nativeTabs和nativeFullScreen，并重启VSCode。
改标题栏不是换个主题就能生效的事，关键得先让 VSCode 愿意渲染它——很多配置写了没反应，根本原因就卡在这一步。
为什么 window.title 配置不生效
最常见的情况是 VSCode 正在用系统原生标题栏（尤其是 macOS），此时 window.title 完全被忽略。必须确认以下三点：
-
window.titleBarStyle设为"custom"（不是"native"） -
window.nativeTabs和window.nativeFullScreen都设为false - 修改的是当前生效的作用域：用户级设置可能被工作区级覆盖，打开文件夹后检查右下角设置图标是否显示“Workspace”
改完必须完全退出 VSCode（不是重载窗口），否则标题栏不会刷新。
常用变量怎么选才不踩空
${branch}、${folderName} 这些变量不是永远有值的，它们依赖上下文：
-
${branch}只在项目根目录存在.git且git.enabled为true时才展开；单文件打开或无 Git 仓库时为空，不是配置错 -
${folderName}在单文件模式（如用code file.js启动）下为空；多根工作区下只取第一个根的名称 -
${fileBasename}和${activeEditorShort}效果一致，都是纯文件名；${file}是绝对路径，极易超长被截断（显示为…） -
${separator}是内置变量，不能写成" | "字符串，否则整个模板失效；想用竖线就直接写"${activeEditorShort} | ${branch}"
推荐组合与避坑写法
兼顾信息量和稳定性，这几个配置实测可用：
"window.title": "${dirty}${activeEditorShort}${separator}${folderName}${separator}${branch}"
-
${dirty}显示 ● 提示未保存，不占宽度 - 去掉
${rootName}—— 多根工作区下它和${folderName}冲突，且含义模糊 - 避免
${fileDirname}：Windows下反斜杠可能引发渲染异常，Linux/macOS 路径深度大时也易截断 - 中文路径不用特别处理，但若标题栏字体发虚，大概率是系统 DPI 缩放导致，VSCode 本身不控制标题栏字体
颜色和边框能调到什么程度
标题栏背景色、文字色可精确控制，但窗口边框颜色支持有限：
- 启用
"window.titleBarStyle": "custom"后，workbench.colorCustomizations中的titleBar.*才生效 -
window.activeBorder等仅在 Linux 生效；macOS/Windows 下边框由系统绘制，无法通过配置改变 - 想微调标题栏高度或按钮间距？VSCode 不开放这类 CSS 变量，硬改需注入自定义 CSS（依赖
vscode-custom-css插件，每次升级后常需重签名）
真正容易被忽略的是：一旦你启用了 native 标题栏，所有颜色配置和 window.title 变量都会静默失效，连错误提示都没有——它只是彻底不读那行配置。
