VSCode颜色配置生效的前提是workbench.colorCustomizations必须作为settings.json顶层字段，键名大小写敏感、值合法且非空；UI色与语法色须分属不同字段，第三方主题可能覆盖配置，改后需重启窗口。
能覆盖，但必须写对位置、用对字段、选对颜色键名——写错一个字母或嵌套错一层，就完全不生效。
workbench.colorCustomizations 必须是 settings.json 顶层字段
很多人改了颜色却没反应，是因为把 workbench.colorCustomizations 塞进了其他对象里，比如包在 "editor": { ... } 或 "files": { ... } 里面。VS Code 只认顶层直系字段。
- ✅ 正确写法：
"workbench.colorCustomizations": { "editor.background": "#1e1e1e" }（直接放在settings.json最外层） - ❌ 错误写法：
"editor": { "workbench.colorCustomizations": { ... } }或"workbench": { "colorCustomizations": { ... } } - ⚠️ 注意：不能写成空对象
{}，也不能用null或注释掉，VS Code 会忽略；要删就整块删干净
UI 色和语法色必须分两个字段配，混写等于白配
想改“状态栏背景”和“字符串颜色”，不是一回事：statusBar.background 属于 UI 色，归 workbench.colorCustomizations 管；"string" 这种是语法 token，归 editor.tokenColorCustomizations 管，二者互不干扰。
- UI 色键名示例：
sideBar.background、tab.activeBackground、activityBar.activeBackground（大小写敏感，activitybar就无效） - 语法色必须用
textMateRules数组结构，不能平铺写"strings": "#ce9178"；正确写法是："editor.tokenColorCustomizations": { "textMateRules": [ { "scope": "string", "settings": { "foreground": "#ce9178" } } ] } - 查真实 scope：用命令
Developer: Inspect Editor Tokens and Scopes，把光标停在代码上，看右上角显示的完整作用域（如string.quoted.double.js）
第三方主题会偷偷覆盖你的配置，得显式重写或关掉它
装了 Nord、One Dark Pro 这类主题插件后，它们常自带 tokenColorCustomizations，甚至通过 themeColor 强制注入 UI 色。你写的配置可能被静默覆盖。
- 检查是否生效：打开开发者工具（
Ctrl+Shift+I），右键 UI 元素 → Inspect，看 computed styles 里 color 值来源是 inline style 还是 theme CSS - 关语法接管：设对应插件配置项为
false，例如"nord.enforceSyntaxHighlighting": false - 强制覆盖 UI 色：哪怕主题已设
activityBar.background，你也得在workbench.colorCustomizations里再写一遍，值必须明确，不能留空或依赖继承
改完要重启窗口，不是重载，否则部分状态色不刷新
像 activityBar.activeBackground、tab.hoverBackground 这类依赖交互状态的颜色，只靠保存 settings.json 或重载窗口（Developer: Reload Window）是不够的。
- 必须关闭当前窗口，再重新打开 VS Code（或执行
Developer: Restart Extension Host后手动切换一次主题触发刷新） - 颜色值必须合法：不支持缩写
#fff，得写满 6 位（#ffffff）或带 alpha 的 8 位（#ffffff80） - 暗/亮模式自动适配？不能用 media query，但可写条件块：
"[Default Dark+]": { "editor.background": "#1e1e1e" }，VS Code 会按当前激活主题匹配加载
真正卡住人的从来不是“怎么写”，而是“为什么写了没反应”——绝大多数失效都出在字段层级、键名拼写、第三方插件冲突这三处，而不是逻辑本身。
