VSCode的主题控制UI界面，配色方案控制语法高亮；UI主题通过workbench.colorTheme切换，配色方案需用editor.tokenColorCustomizations手动配置textMateRules规则。
VSCode 的主题和配色方案是两个独立但常被混淆的系统：主题（Theme）控制编辑器整体 UI（侧边栏、状态栏、标题栏等），而配色方案（Color Customization / Token Color Customization）控制代码语法高亮与文本样式。直接改 settings.json 或装个“主题”插件却没生效，大概率是搞混了这两者。
如何区分并正确安装「UI 主题」和「配色方案」
VSCode 市场里搜到的大多数“主题”，其实是 UI 主题（如 One Dark Pro、Dracula Official），它们通过 workbench.colorCustomizations 调整界面颜色，但不碰代码高亮；而真正影响 const、string、comment 这些语法颜色的是 配色方案（Token Colors），它由 editor.tokenColorCustomizations 或单独的 tokenColors 文件定义。
- UI 主题安装后，在设置 →
Appearance→Theme下切换，对应配置项是workbench.colorTheme - 配色方案不能单独安装，必须通过
editor.tokenColorCustomizations手动覆盖，或由某个主题包在package.json里声明contributes.colors和contributes.grammars - 一个插件可以同时提供 UI 主题 + 配色方案（比如
Material Theme），但也可以只提供其一
手动修改配色方案：用 editor.tokenColorCustomizations 覆盖语法高亮
这是最常用也最可控的方式，适合微调已有主题的语法颜色。修改位置在 settings.json，不是 CSS 文件。
- 支持两种写法：对象形式（简单覆盖）或
file引用外部 JSON（适合复杂定制） - 关键字段是
textMateRules，每条规则需含scope（匹配语法范围）和settings（颜色/字体样式） -
scope值可通过Developer: Inspect Editor Tokens and Scopes命令实时查看，比如选中一个函数名，看到support.function.builtin.python - 常见错误：写错 scope 名称（如把
keyword写成keywords）、漏掉引号、在settings.json里用了注释（JSON 不允许）
示例（让 Python 的 def 关键字变橙色）：
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": "keyword.control.flow.python",
"settings": {
"foreground": "#FF9500"
}
}
]
}
自定义 UI 主题：从空白模板开始生成 .vsix
如果你要发布一个完整主题（含 UI + 语法），不能只改 settings.json。必须用官方脚手架 yo code 生成项目结构，其中：
-
themes/xxx-color-theme.json定义tokenColors（语法）和colors（UI）两部分 -
package.json的contributes.themes声明该文件为可用主题 - 最终打包为
.vsix文件才能被其他用户安装；直接放 JSON 到~/.vscode/extensions/不会生效 - 调试时建议用
F5启动 Extension Development Host，避免污染主环境
为什么改了 workbench.colorCustomizations 没反应？
这个配置项只对当前启用的 UI 主题生效，且优先级低于主题自带的 colors 定义。如果主题本身已声明了 statusBar.background，你再在 workbench.colorCustomizations 里设一次，可能被忽略——除非加 !important（不支持）或换用更具体的 scope（如 statusBar.noFolderBackground）。
- 验证是否生效：打开命令面板 →
Developer: Inspect Editor Tokens and Scopes，鼠标悬停在 UI 元素上，看右下角显示的 color key 是否匹配你设置的值 - 常见失效场景：设置了
activityBar.background，但当前主题禁用了 activityBar（如使用Custom CSS and JS Loader插件隐藏了它） - 跨平台差异：Windows 的标题栏、macOS 的原生菜单栏颜色不受
workbench.colorCustomizations控制，需改window.titleBarStyle或用 native theme
真正麻烦的不是怎么改，而是每次更新主题插件后，它的默认配色可能覆盖你的 tokenColorCustomizations，尤其当它升级了 tokenColors 文件结构。建议把自定义规则单独存为片段，升级前 diff 一下。
