VSCode颜色配置是分层叠加、按优先级生效的协作机制，非简单覆盖；workbench.colorCustomizations仅作用于UI色，editor.tokenColorCustomizations仅作用于语法色，二者不可越界，且易被主题插件或语义高亮干扰。
VSCode 自定义颜色配置和插件不是“谁覆盖谁”的简单关系，而是分层叠加、按优先级生效的协作机制。直接改 settings.json 里的 workbench.colorCustomizations 或 editor.tokenColorCustomizations，大概率会被已启用的主题插件静默接管或部分覆盖——尤其当插件自带完整 tokenColors 和 colors 时。
为什么改了 colorCustomizations 却没反应？
常见现象是：你在用户 settings.json 里写了 "editorBracketMatch.background": "#ff0000"，但括号高亮还是蓝的。这不是配置错了，而是被插件主题“劫持”了：
- 第三方主题插件（如 Nord、One Dark Pro）通常在
package.json的contributes.themes中声明完整主题文件，该文件内含colors和tokenColors，会整体接管所有颜色控制权 -
workbench.colorCustomizations确实优先级高于插件主题的colors，但它**不作用于语法高亮**；而括号匹配背景（editorBracketMatch.background）属于 editor UI 色，归它管——所以理论上应生效；但如果插件同时启用了语义高亮（editor.semanticHighlighting）并注册了semanticTokenColors，且其中某条规则命中了括号 token，则可能间接干扰渲染逻辑 - 某些插件（尤其是带“highlight”“rainbow”字样的）会注册自己的
DocumentHighlightProvider或覆盖TextEditorDecorationType，绕过原生颜色系统，此时任何colorCustomizations都无效
theme 插件如何静默忽略你的自定义？
主题插件加载失败时 VSCode 不报错，只默默跳过——这是最隐蔽的坑：
-
themes/your-theme.json缺少tokenColors或colors任一顶层字段 → 整个文件被忽略，Extension 'xxx' has no themes报错 -
package.json中contributes.themes.uiTheme写成"light"或留空 → 主题无法关联到当前编辑器模式，加载失败 - 路径写成
./src/themes/dark-sage.json或文件名含大写DarkSage.json→ VSCode 根本不扫描，主题不出现在列表中 - 你用 TypeScript 写主题逻辑，却把
.ts文件放进themes/→ VSCode 只读 JSON，TS 源码被无视
如何确认当前生效的颜色来源？
别猜，用 VSCode 自带工具实时验证：
- 查 UI 元素色（状态栏、侧边栏、括号高亮等）：打开命令面板 → 运行
Developer: Toggle Developer Tools→ 右键目标界面元素 →Inspect→ 看 DOM class 名（如status-bar-item），再对照官方 color reference 找对应 key - 查语法色（关键字、字符串、函数名等）：光标停在代码上 →
Developer: Inspect Editor Tokens and Scopes→ 面板顶部第一个 scope 是最精确匹配项（如support.function.console.js），下面列出的foreground值就是当前实际生效的颜色 - 检查是否被插件覆盖：禁用所有主题类插件，重启 VSCode，再逐个启用，观察颜色变化节点 —— 最后启用的那个，往往就是“赢家”
插件与自定义配置共存的底线原则
想让自己的颜色设置真正落地，必须接受两个事实：
- VSCode 不允许“全局强制覆盖”；
workbench.colorCustomizations只能覆盖 UI 色，editor.tokenColorCustomizations只能覆盖语法色，二者不能越界 - 插件主题若同时提供
tokenColors和colors，它就拥有完整的主题控制权；你手动加的tokenColorCustomizations会合并进它的tokenColors，但若插件内部用了semanticTokenColors且开启语义高亮，那部分 token 就优先走语义层，你的传统规则可能被跳过 - 真正难的从来不是写 JSON，而是搞清当前 token 到底走的是 TextMate scope 匹配、还是 semantic token 匹配、还是插件自定义 decoration —— 这三者在 DevTools 的 Inspect 面板里会明确分开显示，漏看一行就白调半天
