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},项目名在中间不够醒目