VSCode中如何自定义窗口标题栏

15次阅读

vscode可通过设置window.title自定义窗口标题栏,支持${dirty}${activeEditorShort}—${rootName}—${appName}等变量组合,适配多根工作区并可启用原生标题栏。

VSCode中如何自定义窗口标题栏

VSCode 默认的窗口标题栏显示的是当前打开的文件名和工作区路径,但你可以通过设置 window.title 来自定义它,让它更符合你的工作习惯或团队规范。

使用 window.title 自定义标题格式

VSCode 提供了一组内置变量(如 ${dirty}${activeEditorShort}${rootName} 等),你可以组合它们来构建标题内容。

  • 打开设置(Ctrl+,Cmd+,),搜索 window.title
  • 点击“在 settings.json 中编辑”,添加或修改这一行:

“window.title”: “${dirty}${activeEditorShort} — ${rootName} — ${appName}”

常见变量含义:

  • ${dirty}:有未保存更改时显示 ●
  • ${activeEditorShort}:当前编辑器的文件名(不含路径)
  • ${rootName}:工作区文件夹名;多根工作区时为第一个根名
  • ${rootNameShort}:同上,但会截断长名称
  • ${appName}:固定显示 “visual studio Code”
  • ${separator}:平台默认分隔符(windows 是 `—`,macOS/linux 是 `|`)

适配多根工作区的标题显示

如果你常开多个文件夹,建议用 ${rootName}${rootPath} 明确标识上下文,避免混淆。

  • 想显示完整路径?用 ${rootPath}(注意可能过长)
  • 想区分多个根?可搭配 ${activeFolderShort}(当前聚焦的文件夹名)
  • 示例:“${activeEditorShort}${dirty} • ${activeFolderShort} • ${appName}”

隐藏或简化标题栏(仅限某些系统)

Windows 和 Linux 支持原生标题栏,macos 则默认使用自定义标题栏。若想进一步精简:

  • 设置 "window.titleBarStyle": "native" 启用系统原生标题栏(仅 Windows/Linux)
  • 设置 "window.customMenuBarVisibility": "toggle" 可按 Alt 显示/隐藏菜单栏(Windows/Linux)
  • macOS 用户无法完全隐藏标题栏,但可通过 title 设置控制其内容

基本上就这些。改完保存,重启窗口或重新加载窗口(Ctrl+Shift+P → “Developer: Reload Window”)即可生效。

text=ZqhQzanResources