workbench.colorCustomizations是修改VSCode界面颜色的唯一有效入口，必须作为settings.json顶层字段配置，大小写敏感且仅支持十六进制或rgba值；editor.tokenColorCustomizations则专管代码文本着色，二者职责分离、不可混用。
workbench.colorCustomizations 是改界面颜色唯一真正起效的入口，editor.tokenColorCustomizations 才管代码文本颜色——这两者不混用、不嵌套、不靠猜，才能一次配准。
怎么改侧边栏、状态栏这些 UI 区域的颜色
所有非代码区域（文件树、标签页、底部状态栏、左侧活动栏）都归 workbench.colorCustomizations 管。它只影响“框”和“底”，对 function、"string" 这类词毫无作用。
-
workbench.colorCustomizations必须是settings.json的顶层字段，不能塞进"editor"或"workbench"对象里 - 键名大小写敏感：
sideBar.background有效，sidebar.background完全无效 - 值必须是合法 CSS 颜色字符串：
"#2d2d2d"、"rgba(45, 45, 45, 0.9)"可用；"red"、"hsl(...)"、var(--vscode-editor-background)全部不生效 - 常见关键项优先配这 7 个：
editor.background、sideBar.background、statusBar.background、tab.activeBackground、activityBar.background、editorCursor.foreground、editor.lineHighlightBackground
怎么让注释、函数名、字符串这些代码文本变色
这不是 UI 配色问题，而是语法高亮（TextMate scope）控制。必须用 editor.tokenColorCustomizations + textMateRules 规则，靠 scope 精准匹配。
- scope 不能靠经验写：
comment太宽泛，comment.line.double-slash才是 JS/TS 中双斜杠注释的真实 scope - 务必先按
Ctrl+Shift+P→ 输入Developer: Inspect Editor Tokens and Scopes，把光标停在目标代码上，看面板顶部显示的第一个 scope - 规则结构必须是：
{"scope": "support.function.console.js", "settings": {"foreground": "#ff6b6b"}}—— 缺settings字段会静默失效 - 避免用
identifier或variable这类全局 scope，大文件里会拖慢渲染；优先选带语言后缀的，如variable.other.readwrite.ts
为什么改了配置却没反应
VSCode 不报错，只沉默忽略。最常踩的三个坑，按顺序排查比重装快得多：
- scope 写错或拼错大小写：比如
keyword.control.js写成keywords.control.js（多一个 s），或漏掉.js后缀 - 配置位置错误：把
editor.tokenColorCustomizations塞进了workbench.colorCustomizations里，或写在了用户设置 UI 界面而非settings.json - 被第三方主题覆盖：One Dark Pro、Nord 等主题自带
tokenColors，会压过你的规则；临时切回Default Dark+测试，或关掉主题的语法强化开关（如"nord.enforceSyntaxHighlighting": false）
语义高亮（Semantic Highlighting）和语法高亮冲突怎么办
当你发现改了 editor.tokenColorCustomizations 却没效果，大概率是语言服务器（LSP）启用的语义高亮在起作用。它优先级高于 TextMate 规则，且 scope 更细（比如能区分“参数 name”和“属性 name”）。
- 检查当前语言是否启用了语义高亮：
Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes，看 scope 列表里是否出现variable.parameter、variable.property这类带语义前缀的项 - 若想用语义规则覆盖，默认需改
editor.semanticTokenColorCustomizations，结构与tokenColorCustomizations类似，但 scope 更具体 - 不想被语义高亮干扰？可在对应语言设置中关闭：
"[javascript]": { "editor.semanticHighlighting.enabled": false }
