主题
颜色主题
颜色主题使您能够修改 Visual Studio Code 用户界面中的颜色,以符合您的偏好和工作环境。颜色主题既会影响 VS Code 的用户界面元素,也会影响编辑器的突出显示颜色。

选择不同的颜色主题
-
选择 文件 (File) > 首选项 (Preferences) > 主题 (Theme) > 颜色主题 (Color Theme) 菜单项,或使用 首选项:颜色主题 (Preferences: Color Theme) 命令(⌘K ⌘T (Windows, Linux Ctrl+K Ctrl+T))来显示颜色主题选择器。
-
使用 上 和 下 键浏览列表并预览主题颜色。
-
选择您想要的主题并按下 Enter。
活动颜色主题存储在您的用户 设置 中(键盘快捷键 ⌘, (Windows, Linux Ctrl+,))。
// Specifies the color theme used in the workbench.
"workbench.colorTheme": "Solarized Dark"
来自市场(Marketplace)的颜色主题
VS Code 中预置了多种开箱即用的颜色主题供您尝试。社区已将更多主题上传至 VS Code 扩展市场。
您可以直接从颜色主题选择器中选择 浏览其他颜色主题... (Browse Additional Color Themes...),从 VS Code 市场中选择颜色主题。

或者,您也可以在扩展视图(⇧⌘X (Windows, Linux Ctrl+Shift+X))的搜索框中使用 @category:"themes" 过滤器搜索主题。

根据操作系统配色方案自动切换
Windows 和 macOS 支持浅色和深色配色方案。通过设置 window.autoDetectColorScheme ,可以指示 VS Code 监听操作系统配色方案的更改,并相应地切换到匹配的主题。
同样,您可以使用 window.autoDetectHighContrast 设置来自动检测操作系统是否切换到了高对比度配色方案。
要自定义配色方案更改时使用的主题,您可以在设置编辑器中设置首选的浅色、深色和高对比度主题:
- 工作台:首选深色颜色主题 (Workbench: Preferred Dark Color Theme) - 默认为 Dark Modern
- 工作台:首选浅色颜色主题 (Workbench: Preferred Light Color Theme) - 默认为 Light Modern
- 工作台:首选高对比度颜色主题 (Workbench: Preferred High Contrast Color Theme) - 默认为 Dark High Contrast
- 工作台:首选高对比度浅色颜色主题 (Workbench: Preferred High Contrast Light Color Theme) - 默认为 Light High Contrast

自定义颜色主题
工作台颜色
您可以使用用户 设置 中的 workbench.colorCustomizations 和 editor.tokenColorCustomizations 来自定义您的活动颜色主题。
要设置 VS Code UI 元素(如列表和树(文件资源管理器、建议小部件)、差异编辑器、活动栏、通知、滚动条、拆分视图、按钮等)的颜色,请使用 workbench.colorCustomizations 。

在设置 workbench.colorCustomizations 值时,可以使用智能感知(IntelliSense);若要获取所有可自定义颜色的列表,请参阅 主题颜色参考。
要对特定主题进行自定义,请使用以下语法:
"workbench.colorCustomizations": {
"[Monokai]": {
"sideBar.background": "#347890"
}
}
如果自定义应用于多个主题,您可以指定多个主题名称,或在名称的开头和结尾使用 * 作为通配符。
"workbench.colorCustomizations": {
"[Abyss][Red]": {
"activityBar.background": "#ff0000"
},
"[Monokai*]": {
"activityBar.background": "#ff0000"
}
}
如果主题设置了您不喜欢的颜色或边框,您可以使用 default 将其恢复为原始值。
"workbench.colorCustomizations": {
"diffEditor.removedTextBorder": "default"
}
编辑器语法高亮
要微调编辑器的语法高亮颜色,请在用户 设置 的 settings.json 文件中使用 editor.tokenColorCustomizations 。

预配置的一组语法标记(“注释”、“字符串”等)适用于最常见的构造。如果您需要更多,可以通过直接指定 TextMate 主题颜色规则来实现。

直接配置 TextMate 规则是一项高级技能,因为您需要了解 TextMate 语法的工作原理。有关更多信息,请访问 颜色主题指南。
要自定义特定主题,您可以通过以下方式之一进行操作:
"editor.tokenColorCustomizations": {
"[Monokai]": {
"comments": "#229977"
},
"[*Dark*]": {
"variables": "#229977"
},
"[Abyss][Red]": {
"keywords": "#f00"
}
}
编辑器语义高亮
某些语言(目前为:TypeScript、JavaScript、Java)提供语义标记。语义标记基于语言服务的符号理解,比由正则表达式驱动的 TextMate 语法提供的语法标记更准确。从语义标记计算出的语义高亮显示在语法高亮显示之上,可以纠正并丰富高亮显示效果,如下例所示:
没有语义高亮的“Tomorrow Night Blue”颜色主题

带有语义高亮的“Tomorrow Night Blue”颜色主题

注意基于语言服务符号理解的颜色差异
- 第 10 行:
languageModes被着色为参数。 - 第 11 行:
Range和Position被着色为类,document被着色为参数。 - 第 13 行:
getFoldingRanges被着色为函数。
设置 editor.semanticHighlighting.enabled 是控制是否应用语义高亮的主要开关。它可以取值为 true、false 和 configuredByTheme。
true和false将打开或关闭所有主题的语义高亮。configuredByTheme是默认值,它允许每个主题控制是否启用语义高亮。所有随 VS Code 一起提供的主题(例如默认的“Dark+”)默认都启用了语义高亮。
您可以通过以下方式覆盖主题设置:
"editor.semanticTokenColorCustomizations": {
"[Rouge]": {
"enabled": true
}
}
当启用语义高亮并可用于某种语言时,由主题来决定是否以及如何对语义标记进行着色。某些语义标记是标准化的,并映射到既定的 TextMate 作用域。如果主题对这些 TextMate 作用域有着色规则,则语义标记将以该颜色呈现,无需任何额外的着色规则。
可以在 editor.semanticTokenColorCustomizations 中配置额外的样式规则。
"editor.semanticTokenColorCustomizations": {
"[Rouge]": {
"enabled": true,
"rules": {
"*.declaration": { "bold": true }
}
}
}
要查看计算出的语义标记及其样式,可以使用范围检查器(开发者:检查编辑器标记和作用域 (Developer: Inspect Editor Tokens and Scopes)),它会显示当前光标位置文本的相关信息。

如果给定位置的语言有可用的语义标记且被主题启用,检查工具会显示一个 语义标记类型 (semantic token type) 部分。该部分显示语义标记信息(类型和任意数量的修饰符)以及适用的样式规则。
有关语义标记和样式规则语法的更多信息,请参阅 语义高亮指南。
创建您自己的颜色主题
创建和发布主题扩展很简单。在您的用户设置中自定义颜色,然后使用 开发者:从当前设置生成颜色主题 (Developer: Generate Color Theme From Current Settings) 命令生成主题定义文件。
VS Code 的 Yeoman 扩展生成器 可帮助您生成扩展的其余部分。
请参阅我们扩展 API 部分中的 创建新颜色主题 文章以了解更多信息。
移除默认颜色主题
如果您想从颜色主题选择器中删除 VS Code 自带的一些默认主题,可以在扩展视图(⇧⌘X (Windows, Linux Ctrl+Shift+X))中禁用它们。从扩展视图顶部选择 过滤扩展 (Filter Extensions) 按钮,选择 内置 (Built-in) 选项,您会看到一个列出默认主题的 主题 (THEMES) 部分。

您可以像禁用任何其他 VS Code 扩展 一样,通过齿轮上下文菜单上的 禁用 (Disable) 命令来禁用内置主题扩展。

文件图标主题
文件图标指示特定文件类型。这些图标显示在资源管理器视图和选项卡标题中的文件名旁边。文件图标主题可以由扩展贡献。
选择不同的文件图标主题
-
选择 文件 (File) > 首选项 (Preferences) > 主题 (Theme) > 文件图标主题 (File Icon Theme) 菜单项,或使用 首选项:文件图标主题 (Preferences: File Icon Theme) 命令来显示文件图标主题选择器。
-
使用 上 和 下 键浏览列表并预览主题图标。
-
选择您想要的主题并按下 Enter。
![]()
默认情况下,使用 Seti 文件图标主题,这就是您在资源管理器视图中看到的图标。VS Code 会在重新启动后记住您的文件图标主题选择。您可以通过选择 无 (None) 来禁用文件图标。
VS Code 附带了两个文件图标主题:Minimal 和 Seti。要安装更多文件图标主题,请在文件图标主题选择器中选择 安装其他文件图标主题 (Install Additional File Icon Themes) 项,这将打开过滤后的扩展视图。
您也可以直接浏览 VS Code 市场 网站以查找可用主题。
活动的活动文件图标主题将保留在您的用户 设置 中(键盘快捷键 ⌘, (Windows, Linux Ctrl+,))。
// Specifies the file icon theme used in the workbench.
"workbench.iconTheme": "vs-seti"
创建您自己的文件图标主题
您可以根据图标(最好是 SVG)创建自己的文件图标主题,有关详细信息,请参阅我们扩展 API 部分中的 文件图标主题 文章。
Web 版 VS Code
VS Code for the Web 在 https://vscode.dev 提供了一个完全在浏览器中运行的免费、免安装的 VS Code 体验。
您可以通过 URL 方案 https://vscode.dev/editor/theme/<extensionId> 分享和体验颜色主题。
例如,您可以访问 https://vscode.dev/editor/theme/sdras.night-owl 体验 Night Owl 主题,而无需进行下载和安装。
您可以在 VS Code for the Web 文档 中了解有关预览和共享主题的更多信息。
产品图标主题
产品图标主题使您能够更改 VS Code 用户界面中的图标,而非特定文件类型的图标。例如,您可以修改活动栏中视图的图标,或者标题栏中用于更改布局的图标。
注意下图中,选择不同的产品图标主题时活动栏图标是如何更新的。
![]()
选择不同的产品图标主题
-
选择 文件 (File) > 首选项 (Preferences) > 主题 (Theme) > 产品图标主题 (Product Icon Theme) 菜单项,或使用 首选项:产品图标主题 (Preferences: Product Icon Theme) 命令来显示产品图标主题选择器。
-
使用 上 和 下 键浏览列表并预览主题图标。
-
选择您想要的主题并按下 Enter。
默认情况下,VS Code 自带一个产品图标主题:默认 (Default)。您可以从产品图标主题选择器中选择 浏览其他产品图标主题... (Browse Additional Product Icon Themes...),从 VS Code 市场中选择更多产品图标主题。
后续步骤
主题只是自定义 VS Code 的一种方式。如果您想了解更多关于 VS Code 自定义和可扩展性的信息,请尝试以下文章:
