真正生效的VSCode UI配色配置只有workbench.colorCustomizations，必须作为settings.json顶层字段，键名严格匹配官方token（如sideBar.background），值支持十六进制等合法CSS颜色，部分属性如activityBar.activeBackground需重启窗口才生效。
workbench.colorCustomizations 改 UI 颜色，不是 theme 或 CSS
VSCode 插件本身不能直接改 UI 颜色——真正起效的只有 workbench.colorCustomizations 这个配置项。装一堆主题插件却不配它，等于白装；改 settings.json 里其他字段（比如 editor.background 却没包在 workbench.colorCustomizations 里），也完全无效。
常见错误现象：侧边栏、状态栏、标签页颜色死活不变；改了 editor.background 却发现编辑区还是亮的。
-
workbench.colorCustomizations必须是settings.json的顶层字段，不能嵌套在"editor"或"workbench"对象里 - 键名必须严格匹配官方 token，比如
sideBar.background（注意大小写，sidebar.background会失效） - 值支持
"#1e1e1e"、"rgba(30, 30, 30, 0.9)"、"transparent"，甚至可引用变量如"editor.background" - 改完保存后，大部分 UI 色实时生效，但
activityBar.activeBackground、tab.activeBackground等需彻底重启 VSCode（关所有窗口再重开）
editor.tokenColorCustomizations 控制编辑区语法色，和 UI 分开
想调 "string"、function、// comment 的颜色？这不是 UI 配置的事，得走 editor.tokenColorCustomizations。它和 workbench.colorCustomizations 完全隔离，混写或漏配都会导致“代码颜色没变”。
常见错误现象：改了主题却觉得关键字还是灰的；手动设了 "strings": "#ce9178" 但没效果。
-
editor.tokenColorCustomizations必须用textMateRules数组结构，不能平铺写键值对 - scope 不能靠猜——按
Ctrl+Shift+P→ 运行Developer: Inspect Editor Tokens and Scopes，把光标停在目标代码上，看右上角显示的真实 scope（比如string.quoted.double.js） - 第三方主题（如 Nord、One Dark Pro）常自带
tokenColorCustomizations，会覆盖你的设置；可加配置"nord.enforceSyntaxHighlighting": false关闭其接管 - 想只影响某语言？加
"language": "python"字段限定
为什么改了 editor.background 却没变？检查这三处
editor.background 是编辑器内容区背景，但它极易被干扰，不是改了就一定生效。
- 当前启用的
workbench.colorTheme（比如 Nord）如果自带editor.tokenColorCustomizations，可能强制覆盖背景渲染逻辑 - 工作区级
.vscode/settings.json里写了同名配置，会完全屏蔽用户级设置；建议先删掉工作区里的workbench.colorCustomizations测试 - 某些主题（如 GitHub Theme）依赖系统暗色模式开关——系统没开暗色，它就回退到亮色变体，
editor.background值再对也白搭
快捷键 Ctrl+K Ctrl+T 只换 UI 主题，不碰编辑区
Ctrl+K Ctrl+T（Win/Linux）或 Cmd+K Cmd+T（macOS）只切换 workbench.colorTheme，它不改 editor.tokenColorScheme。漏掉后者，“换完主题代码还是亮得刺眼”是常态。
- 统一暗色体验的最小操作：选好 UI 主题后，在设置里搜
token color scheme，手动选同名或兼容的语法主题（比如选Dark+UI 后，再设"editor.tokenColorScheme": "Dark+"） - 快捷键没反应？焦点可能不在主窗口（比如卡在终端或调试控制台），先按
Esc退出输入态；或检查快捷键是否被插件覆盖（命令面板搜workbench.action.selectTheme） - 想真正一键切深/浅模式？得脚本改
settings.json+ 重载窗口，VSCode 不原生联动系统夜间模式
workbench.colorCustomizations，编辑区语法靠 editor.tokenColorCustomizations。二者互不干扰，但都要求 token 名准确、结构合规、作用域清晰——错一个字母、少一层括号、多一个缩进，整条配置就静默失效。 
