VSCode 自定义窗口标题

概述

通过 window.title 设置可以自定义 VSCode 标题栏显示内容,例如以项目名为前缀,方便在多窗口间快速区分。

配置方法

settings.json 中设置 window.title

{
  "window.title": "${rootName} — ${activeEditorShort}${separator}${appName}"
}

效果示例:obsidian-vault — CLAUDE.md — Visual Studio Code

如果想更紧凑突出项目名:

"window.title": "[${rootName}] ${activeEditorMedium}${dirty}"

效果:[obsidian-vault] src/main.ts ●

可用变量

变量含义
${rootName}工作区/文件夹名(项目名)
${rootPath}工作区完整路径
${activeEditorShort}当前文件名
${activeEditorMedium}当前文件相对路径
${activeEditorLong}当前文件完整路径
${activeFolderShort}当前文件所在文件夹名
${activeFolderMedium}当前文件所在文件夹相对路径
${appName}”Visual Studio Code”
${dirty}文件有未保存修改时显示 标记
${separator}条件分隔符(两侧都有值时才显示)
${remoteName}远程连接名称(SSH/WSL 等)
${profileName}当前 Profile 名称

技巧与注意事项

  • 多显示器/多项目并行时,加 ${rootName} 前缀能大幅提升窗口辨识度
  • ${separator} 是智能分隔符,只在两侧变量都有值时才显示,避免出现多余的
  • Remote SSH / WSL 场景下可加 ${remoteName} 区分本地和远程窗口
  • 默认值为 ${dirty}${activeEditorShort}${separator}${rootName}${separator}${profileName}${separator}${appName},项目名在中间不够醒目

相关链接