vscode调色需分清ui元素、语法token、git装饰色三层：ui色用workbench.colorcustomizations（顶层字段，键名大小写敏感，值仅支持十六进制或rgba），语法色用editor.tokencolorcustomizations，括号高亮背景属ui层，配editorbracketmatch.background；注释色属语法层，须配tokencolorcustomizations中comments；优先级上工作区设置覆盖用户级，主题可能间接覆盖背景色，调试需用开发者工具查class或token。
改 VSCode 颜色不是换主题就完事，真要调准某一块颜色（比如侧边栏背景、括号高亮、注释文字），必须分清三件事：改的是 UI 元素、语法 token 还是 Git 装饰色；配置项写在哪层 JSON；值有没有被更高优先级的设置覆盖。
workbench.colorCustomizations 是改 UI 颜色的唯一入口
想调侧边栏、状态栏、标签页底边线、编辑器背景、括号匹配背景这些“界面框和底”，workbench.colorCustomizations 是唯一有效路径。装再多主题插件也没用——它们只是预设包，最终生效还得靠你手动写 JSON 覆盖。
-
workbench.colorCustomizations必须是settings.json的顶层字段，和"editor.fontSize"并列，不能嵌在editor.tokenColorCustomizations里，否则整段静默失效 - 键名大小写敏感：
activityBar.foreground不是activitybar.foreground，拼错一个字母或加空格，VS Code 就不认 - 值只支持
"#1e1e1e"、"rgba(30, 30, 30, 0.9)"，别用hsl()或darkgray，跨平台渲染不稳定 - 工作区级
.vscode/settings.json会完全覆盖用户级设置，调色前先确认没被它屏蔽
editorBracketMatch.background 控制括号高亮背景
括号匹配背景不是语法色，而是 UI 元素，所以归 workbench.colorCustomizations 管，不是 editor.tokenColorCustomizations。很多人搜 “bracket highlight color” 结果配错地方，最后发现怎么都改不动。
- 正确 key 是
editorBracketMatch.background，不是bracketMatchBackground或editor.bracketMatchBackground - 它只控制括号对齐时的浅色背景，不影响光标或边框颜色
- 如果用了 Nord、GitHub Dark 等主题，它们可能自带
editor.tokenColorCustomizations，会间接影响括号区域渲染逻辑，建议先临时禁用主题插件验证 - 值设为
"#ff000033"（半透红）比纯色更柔和，但注意：透明度在部分显卡驱动下可能渲染异常
editor.background 改了却没变？先查这三处
editor.background 是唯一控制代码编辑区底色的配置项，但它最容易“看似生效实则被盖”。不是你写错了，大概率是优先级或作用域问题。
- 当前启用的颜色主题（
workbench.colorTheme）如果自带editor.tokenColorCustomizations，可能覆盖你的设置——部分主题（如 Nord）默认强制接管语法色，连带影响背景渲染逻辑 - 工作区级
.vscode/settings.json里写了同名配置，会完全屏蔽用户级设置；建议先删掉工作区里的workbench.colorCustomizations测试 - 某些主题（如 GitHub Theme）依赖系统暗色模式开关，系统没开暗色，它就回退到亮色变体，
editor.background值再对也白搭
tokenColorCustomizations 和 colorCustomizations 职责分离
这是最常踩的坑。前者管语法着色（function、"string"、// comment），后者管界面元素（侧边栏、状态栏、括号背景）。混着配，改一百遍也调不出效果。
- 想调高亮括号背景？用
workbench.colorCustomizations下的editorBracketMatch.background - 想改注释颜色？得去
editor.tokenColorCustomizations下配comments - 查 token 名不能靠猜：按
Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes，点一下代码就能看到实时 token 类型和 color key - 查 UI 元素 class 名：按
Ctrl+Shift+I打开开发者工具，右键界面元素 →Inspect，看 class 后对照官方 color reference 文档
真正难的不是写对一行 JSON，而是搞清你改的到底属于哪一层——UI、语法、语义还是 Git 装饰。一旦错层，所有修改都像往雾里扔石头，听不见回响。
