主题

色彩主题

色彩主题允许您在Visual Studio Code用户界面中修改颜色,以符合您的偏好和工作环境。颜色主题既影响 VS Code 的用户界面元素,也影响用于突出颜色的编辑器。

来自命令调色板的预览主题

选择不同的颜色主题:

  1. 选择偏好设置>>主题>颜色主题菜单项,或使用偏好设置:颜色主题命令(⌘K ⌘T(Windows,Linux Ctrl+K Ctrl+T)来显示颜色主题选择器。

  2. 使用上下键浏览列表并预览主题颜色。

  3. 选择你想要的主题,然后按回车

当前的颜色主题存储在用户设置中(键盘快捷键⌘,(Windows,Linux Ctrl+,)。

  // Specifies the color theme used in the workbench.
  "workbench.colorTheme": "Solarized Dark"
提示

默认情况下,主题存储在用户设置中,并全局应用到所有工作区。你也可以配置一个工作区专属的主题。要做到这一点,可以在工作区设置中设置主题。

设置编辑器截图,用于设置工作区专用的颜色主题。

市场主题色彩

VS Code 里有几种开箱即用的色彩主题供你尝试。社区已经上传了更多主题到 VS Code 扩展市场

你可以直接从VS Code市场的颜色主题选择器中选择“浏览其他颜色主题......”来选择颜色主题。

颜色主题选择器的截图,突出显示了在VS Code市场浏览主题的选项。

或者,你也可以在扩展视图(⇧⌘X(Windows,Linux Ctrl+Shift+X)搜索框中搜索主题,方法是使用@category:“主题”过滤。

在扩展视图中搜索主题

根据作系统的配色方案自动切换

Windows和macOS支持浅色和深色配色方案。有一个设定,

window.autoDetectColorScheme
  • 在VS代码中打开
  • 在VS Code Insiders中开放
该指令指令VS Code监听作系统色彩方案的变化,并相应切换到匹配的主题。

同样,你也可以使用

window.autoDetect高对比度
  • 在VS代码中打开
  • 在VS Code Insiders中开放
设置以自动检测作系统是否切换到高对比度配色方案。

要自定义颜色方案变化时使用的主题,可以在设置编辑器中设置首选的明暗和高对比度主题:

  • 工作台:首选深色主题——默认为深现代
  • 工作台:首选浅色主题——默认为浅色现代
  • 工作台:首选高对比度色彩主题——默认为深色高对比度
  • 工作台:首选高对比度浅色主题——默认为浅色高对比度

设置编辑器,已根据首选颜色主题设置进行筛选

自定义色彩主题

工作台颜色

你可以用以下内容自定义你的主动色彩主题

workbench.color自定义
  • 在VS代码中打开
  • 在VS Code Insiders中开放
以及
editor.token颜色自定义
  • 在VS代码中打开
  • 在VS Code Insiders中开放
用户设置

要设置VS Code界面元素的颜色,如列表和树状结构(文件资源管理器、建议小部件)、差异编辑器、活动栏、通知、滚动条、分屏视图、按钮等,请使用

workbench.color自定义
  • 在VS代码中打开
  • 在VS Code Insiders中开放
.

活动栏主题

你可以在设置时使用 IntelliSense

workbench.color自定义
  • 在VS代码中打开
  • 在VS Code Insiders中开放
或者,所有可自定义颜色的列表请参见主题色彩参考

要对特定主题进行定制,请使用以下语法:

"workbench.colorCustomizations": {
    "[Monokai]": {
        "sideBar.background": "#347890"
    }
}

如果自定义适用于多个主题,你可以为多个主题命名,或者在名称的开头和结尾使用通配符:*

"workbench.colorCustomizations": {
    "[Abyss][Red]": {
        "activityBar.background": "#ff0000"
    },
    "[Monokai*]": {
        "activityBar.background": "#ff0000"
    }
}

如果某个主题设置了你不喜欢的颜色或边框,你可以使用默认要将其恢复到原始值:

  "workbench.colorCustomizations": {
      "diffEditor.removedTextBorder": "default"
  }

编辑器语法高亮

要调整编辑器中高亮颜色的语法,请使用

editor.token颜色自定义
  • 在VS代码中打开
  • 在VS Code Insiders中开放
在你的用户设置 settings.json文件:

令牌颜色自定义

为最常见的构造提供了预配置的语法标记集(“注释”、“字符串”等)。如果你想要更多,可以通过直接指定TextMate主题颜色规则来实现:

高级令牌颜色定制

注释

直接配置TextMate规则是一项高级技能,因为你需要理解TextMate语法的工作原理。更多信息请访问色彩主题指南

要自定义特定主题,可以通过以下方式之一实现:

"editor.tokenColorCustomizations": {
    "[Monokai]": {
        "comments": "#229977"
    },
    "[*Dark*]": {
        "variables": "#229977"
    },
    "[Abyss][Red]": {
        "keywords": "#f00"
    }
}

编辑语义高亮

一些语言(目前包括:TypeScript、JavaScript、Java)提供语义标记。语义符号基于语言服务的符号理解,比由正则表达式驱动的TextMate语法符号更准确。从语义标记计算出的语义高亮建立在语法高亮之上,可以纠正和丰富高亮,如下例所示:

“明天夜蓝”主题,无语义高亮:

无语义高亮

“明天夜蓝”色彩主题及语义高亮:

带语义高亮

注意基于语言服务符号理解的颜色差异:

  • 第10行:语言模式作为参数被标记。
  • 第11行:分布范围以及职位以类和颜色表示文件作为一个参数。
  • 第13行:getFoldingRanges作为函数被标记为颜色。

背景设定

editor.semanticHighlighting.enabled
  • 在VS代码中打开
  • 在VS Code Insiders中开放
作为是否应用语义高亮的主要控制。它可以有数值确实如此,错误, 和配置dBy主题.

  • 确实如此以及错误为所有主题开启或关闭语义高亮。
  • 配置dBy主题是默认设置,每个主题可以控制是否启用语义高亮。所有随VS Code自带的主题(比如“Dark+”默认)默认都启用了语义高亮。

你可以通过以下方式覆盖主题设置:

"editor.semanticTokenColorCustomizations": {
    "[Rouge]": {
        "enabled": true
    }
}

当语言启用并启用语义高亮时,主题自行配置语义标记的颜色及颜色方式。部分语义标记是标准化的,并映射到成熟的TextMate范围。如果主题为这些TextMate范围有着色规则,语义标记就会用该颜色渲染,无需额外的着色规则。

还可以在editor.semanticTokenColorCustomizations”:

"editor.semanticTokenColorCustomizations": {
    "[Rouge]": {
        "enabled": true,
        "rules": {
            "*.declaration": { "bold": true }
        }
    }
}

要查看计算的语义标记及其样式,可以使用范围检查器(开发者:检查编辑器标记和范围),它显示当前光标位置的文本信息。

范围检查员

如果该语言在指定位置有语义标记,并且由主题启用,检查工具会显示一个节语义标记类型。该部分展示了语义标记信息(类型及任意数量的修饰符)以及适用的样式规则。

关于语义标记和样式规则语法的更多信息,请参阅语义高亮指南

创建你自己的色彩主题

创建和发布主题扩展很简单。在用户设置中自定义颜色,然后用开发者命令生成主题定义文件。

VS Code 的 Yeoman 扩展生成器帮你生成剩余的扩展。

详情请参阅我们扩展API部分的“创建新颜色主题”条目。

移除默认的色彩主题

如果你想从颜色主题选择器中移除 VS Code 默认的部分主题,可以在扩展视图中禁用它们(⇧⌘X(Windows,Linux Ctrl+Shift+X)。从扩展视图顶部选择“筛选扩展”按钮,选择“内置”选项,你会看到一个主题部分,列出默认主题。

内置主题

你可以像禁用其他VS Code扩展一样,在齿轮菜单里用“禁用”命令禁用内置主题扩展。

关闭主题

文件图标主题

文件图标表示特定的文件类型。这些图标会在资源管理器视图中与文件名并列,并出现在标签页中。文件图标主题可以通过扩展贡献。

要选择不同的文件图标主题:

  1. 选择“文件>偏好设置”>主题“>”文件图标主题“菜单项项,或使用偏好设置:文件图标主题命令显示文件图标主题选择器。

  2. 使用上下键在列表中导航并预览主题图标。

  3. 选择你想要的主题,然后按回车

文件图标主题下拉菜单

默认情况下,使用Seti文件图标主题,这些图标就是你在资源管理器视图中看到的。VS Code 会记住你在重启后选择的文件图标主题。你可以选择“无”来禁用文件图标。

VS Code 附带两个文件图标主题:最小化Seti。要安装更多文件图标主题,请在文件图标主题选择器中选择“安装额外文件图标主题”项,该选项会打开按图标主题筛选的扩展视图。

你也可以直接浏览VS Code市场网站,查找可用的主题。

活跃的文件图标主题会在用户设置中保持(键盘快捷键⌘,(Windows,Linux Ctrl+,)。

  // Specifies the file icon theme used in the workbench.
  "workbench.iconTheme": "vs-seti"

创建您自己的文件图标主题

你可以从图标(最好是 SVG)创建自己的文件图标主题,详情请参见我们扩展 API 部分的文件图标主题文章。

面向网络的VS代码

VS Code for the Web 提供免费、零安装的 VS Code 体验,完全运行在你的浏览器中,且在 https://vscode.dev

您可以通过 URL 架构通过 VS Code for the Web 分享和体验色彩主题:https://vscode.dev/editor/theme/<extensionId>.

例如,你可以直接进入 https://vscode.dev/editor/theme/sdras.night-owl 体验夜猫子主题,而无需经历下载和安装过程。

你可以在 VS Code for the Web 文档中了解更多关于预览和共享主题的内容。

产品图标主题

产品图标主题允许你在VS Code用户界面中更改图标,但不包括特定文件类型的图标。例如,你可以修改活动栏视图的图标,或标题栏中的图标来更改布局。

请注意下图中活动栏图标在选择不同产品图标主题时的更新。

产品图标主题下拉菜单的截图,以及活动栏图标的变化。

选择不同的产品图标主题:

  1. 选择“>偏好设置”文件,>主题>产品图标主题菜单项,或使用偏好设置:产品图标主题命令显示产品图标主题选择器。

  2. 使用上下键在列表中导航并预览主题图标。

  3. 选择你想要的主题,然后按回车

默认情况下,VS Code 带有一个产品图标主题,默认。您可以通过选择“浏览其他产品图标主题......”直接从产品图标主题选择器中,从VS代码市场中选择更多产品图标主题。

下一步

主题只是定制VS Code的一种方式。如果你想了解更多关于VS Code的定制化和可扩展性,可以试试这些文章:

  • 设置 - 学习如何通过用户和工作区设置将 VS Code 配置到你的偏好中。
  • 片段——添加你喜欢的语言中的额外片段。
  • 扩展API——了解其他扩展VS Code的方法。
  • Color Theme - Color Theme 扩展 API。
  • 文件图标主题 - 文件图标主题扩展 API。