颜色主题
Visual Studio Code 用户界面中可见的颜色分为两类
- 工作台颜色:用于视图和编辑器,从活动栏到状态栏。所有这些颜色的完整列表可在主题颜色参考中找到。
- 语法颜色和样式:用于编辑器中的源代码。这些颜色的主题化有所不同,因为语法着色基于 TextMate 语法和 TextMate 主题以及语义令牌。
本指南将介绍创建主题的不同方法。
工作台颜色
创建新工作台颜色主题最简单的方法是使用现有颜色主题并对其进行自定义。首先切换到您要修改的颜色主题,然后打开您的设置并更改workbench.colorCustomizations
设置。更改会实时应用于您的 VS Code 实例。
例如,以下内容将更改标题栏的背景颜色
{
"workbench.colorCustomizations": {
"titleBar.activeBackground": "#ff0000"
}
}
所有可主题化颜色的完整列表可在颜色参考中找到。
语法颜色
对于语法高亮颜色,有两种方法。您可以引用社区中的现有 TextMate 主题(.tmTheme
文件),或者您可以创建自己的主题规则。最简单的方法是使用现有主题并对其进行自定义,就像上面工作台颜色部分一样。
首先切换到要自定义的颜色主题并使用editor.tokenColorCustomizations
设置。更改会实时应用于您的 VS Code 实例,无需刷新或重新加载。
例如,以下内容将更改编辑器中注释的颜色
{
"editor.tokenColorCustomizations": {
"comments": "#FF0000"
}
}
该设置支持一个简单的模型,其中包含一组常见的令牌类型,如“注释”、“字符串”和“数字”。如果您想为更多内容着色,则需要直接使用 TextMate 主题规则,这在语法高亮指南中有详细解释。
语义颜色
语义高亮在 VS Code 1.43 版中可用于 TypeScript 和 JavaScript。我们预计它很快将被其他语言采用。
语义高亮基于语言服务中的符号信息丰富语法着色,该服务对项目有更完整的理解。一旦语言服务器运行并计算出语义令牌,着色更改就会出现。
每个主题都通过主题定义中的特定设置来控制是否启用语义高亮。每个语义令牌的样式由主题的样式规则定义。
用户可以使用editor.tokenColorCustomizations
设置覆盖语义高亮功能和着色规则
为特定主题启用语义高亮
"editor.tokenColorCustomizations": {
"[Material Theme]": {
"semanticHighlighting": true
}
},
主题可以根据语法高亮指南中的描述为语义令牌定义主题规则。
创建新颜色主题
使用workbench.colorCustomizations
和editor.tokenColorCustomizations
调整主题颜色后,就可以创建实际主题了。
-
使用命令面板中的开发者:从当前设置生成颜色主题命令生成主题文件
-
使用 VS Code 的Yeoman 扩展生成器生成新的主题扩展
npm install -g yo generator-code yo code
-
如果您按上述方式自定义了主题,请选择“全新开始”。
-
将从您的设置生成的主题文件复制到新扩展。
您也可以通过告诉扩展生成器导入 TextMate 主题文件(.tmTheme)并将其打包以在 VS Code 中使用来使用现有 TextMate 主题。或者,如果您已经下载了主题,请用指向要使用的.tmTheme
文件的链接替换tokenColors
部分。
{
"type": "dark",
"colors": {
"editor.background": "#1e1e1e",
"editor.foreground": "#d4d4d4",
"editorIndentGuide.background": "#404040",
"editorRuler.foreground": "#333333",
"activityBarBadge.background": "#007acc",
"sideBarTitle.foreground": "#bbbbbb"
},
"tokenColors": "./Diner.tmTheme"
}
提示:为您的颜色定义文件添加
-color-theme.json
后缀,您将在编辑时获得悬停提示、代码完成、颜色装饰器和颜色选择器。
提示:ColorSublime有数百个现有 TextMate 主题可供选择。选择您喜欢的主题并复制下载链接以在 Yeoman 生成器或您的扩展中使用。它将采用
"https://raw.githubusercontent.com/Colorsublime/Colorsublime-Themes/master/themes/(name).tmTheme"
之类的格式
测试新颜色主题
要试用新主题,请按 F5 启动扩展开发主机窗口。
在该窗口中,通过文件 > 首选项 > 主题 > 颜色主题打开颜色主题选择器,您可以在下拉列表中看到您的主题。向上和向下箭头可以实时预览您的主题。
对主题文件的更改会实时应用于Extension Development Host
窗口。
将主题发布到扩展市场
如果您想与社区分享您的新主题,可以将其发布到扩展市场。使用vsce 发布工具打包您的主题并将其发布到 VS Code 市场。
提示:为了让用户更容易找到您的主题,请在扩展描述中包含“主题”一词,并在
package.json
中将Category
设置为Themes
。
我们还有关于如何让您的扩展在 VS Code 市场上看起来很棒的建议,请参阅市场展示提示。
添加新颜色 ID
颜色 ID 也可以通过颜色贡献点由扩展提供。当在workbench.colorCustomizations
设置和颜色主题定义文件中使用代码完成时,这些颜色也会出现。用户可以在扩展贡献选项卡中查看扩展定义了哪些颜色。