workbench.colorcustomizations 修改无反应是因为空对象{}会阻止主题默认颜色注入，且它只影响ui元素不控制语法着色；需删除或注释该配置并重启主题验证，后续微调须写完整键值对。
workbench.colorCustomizations 为什么改了没反应？
它确实优先级最高，但只管 UI 元素（侧边栏、状态栏、括号高亮），不管语法着色；而且只要存在空对象 {}，就会阻止主题默认颜色注入。
- 打开命令面板，运行
Preferences: Open Settings (JSON)，搜索workbench.colorCustomizations - 整段删掉或注释掉，保存后按
Ctrl+K Ctrl+T切回同一主题，立刻验证是否恢复 - 若生效，说明它在“抢权”；后续如需微调，应直接写完整键值对，比如
"editor.background": "#1e1e1e"，别留空对象 - 注意：该字段必须是
settings.json的顶层字段，不能嵌套在其他配置里
主题选单里找不到刚装的插件？
不是安装失败，而是主题注册没通过校验——VSCode 对主题 JSON 文件有硬性结构要求，缺一不可。
- 确认主题文件路径是
./themes/xxx.json（必须在扩展根目录下，不能是src/themes/或带空格/大写） - 打开该 JSON，检查是否同时包含
colors和tokenColors两个顶层字段（拼写不能错，不能是Colors或token_colors） -
colors里键名必须是官方 color ID（如editor.background），不能自创；tokenColors是数组，每项必须含scope和settings - 如果 package.json 中
contributes.themes指向路径错误，或uiTheme值写成"light"而当前是暗色模式，也会加载失败
界面变色了但代码还是灰白一片？
这是典型的“UI 主题生效、语法主题没加载”——两者完全独立，主题插件可能只提供了 colors，没配 tokenColors。
- 按
Ctrl+Shift+P运行Developer: Inspect Editor Tokens and Scopes，把光标停在关键词（如function）上，看左下角显示的 scope（比如keyword） - 若 scope 显示为空或只有
source.ts，说明语法高亮规则根本没加载；此时需确认主题 JSON 是否真含tokenColors数组，且至少有一条匹配规则 - 某些语言（如 TypeScript）会优先用
semanticTokenColors，但默认关闭；如需启用，得手动设"editor.semanticHighlighting": true - 别指望一个主题自动适配所有语言——Markdown、Shell 等常被忽略，得单独补
tokenColors规则
工作区设置为什么总覆盖我的主题选择？
.vscode/settings.json 拥有最高优先级，哪怕只写错一个引号，都会让主题切换失效，且不报错。
- 进项目根目录，检查是否存在
.vscode/settings.json - 打开它，搜索
"workbench.colorTheme"，确认值是你想用的主题 ID（如"catppuccin-mocha"），不是拼错的"catpuccin"或已弃用的旧 ID - 临时重命名该文件为
settings.json.bak，再执行Developer: Reload Window测试 - 状态栏右下角显示的主题 ID 必须和命令面板中选中的完全一致——
one-dark-pro≠one-dark-pro-vivid
workbench.colorCustomizations 的存在本身，以及 .vscode/settings.json 里那个不起眼的引号错误。
