VSCode 中 workbench.colorCustomizations 未生效，主因是高优先级配置覆盖：工作区设置、主题扩展劫持或 colorTheme 错误导致降级。需检查 JSON 合法性、逐层排查覆盖源并重载窗口。
改了 workbench.colorCustomizations 却没反应？不是配置写错了，大概率是它被更高优先级的设置或扩展悄悄覆盖了。
检查 workbench.colorCustomizations 是否被清空或误删
这个配置项必须是合法 JSON 对象，且不能为 null 或字符串。常见错误包括：
- 手动删掉了整个
"workbench.colorCustomizations"字段，结果 VSCode 回退到主题默认值（你以为“没生效”，其实是恢复了原样） - 留着字段但值写成
"workbench.colorCustomizations": null或"{}"—— 空对象 {} 会触发覆盖逻辑，直接屏蔽主题自带配色 - JSON 格式错误：比如最后一行多加了逗号、引号不匹配，VSCode 会静默忽略整块配置
实操建议：打开 Preferences: Open Settings (JSON)，确认该字段存在且结构类似：
{
"workbench.colorCustomizations": {
"statusBar.background": "#2a2a2a",
"activityBar.foreground": "#ffffff"
}
}
确认没有工作区 .vscode/settings.json 强制覆盖
项目根目录下的 .vscode/settings.json 拥有最高优先级，会无条件压倒用户级设置。哪怕只有一行 "workbench.colorTheme": "Default Dark+"，也会让所有自定义颜色失效。
- 进当前项目文件夹，检查是否存在
.vscode/settings.json - 打开它，搜索
workbench.colorCustomizations和workbench.colorTheme - 临时重命名该文件为
.vscode/settings.json.bak，再执行Developer: Reload Window - 若颜色立刻恢复，说明问题出在这里——不要直接删，而是逐条核对并移除冲突项
排查第三方主题扩展动态劫持颜色
像 One Dark Pro、Material Theme 这类插件，启动后会主动注入自己的 workbench.colorCustomizations，把你手写的配置顶掉。这不是 bug，是设计行为。
- 打开扩展视图（
Ctrl+Shift+X），搜theme，禁用所有非必需的主题类扩展 - 只保留你正在调试的那个主题（比如
Catppuccin），其他全关 - 执行
Developer: Reload Window，观察是否恢复 - 某些插件提供专属配置项（如
"catppuccin.colorScheme"），应优先用它微调，而非硬写workbench.colorCustomizations
验证是否被 workbench.colorTheme 值本身干扰
颜色自定义依赖当前激活的主题。如果 workbench.colorTheme 指向一个已卸载、拼错 ID 或根本不存在的主题，VSCode 会降级使用 Default Light+，此时你的 colorCustomizations 仍存在，但作用目标已变。
- 执行
Preferences: Color Theme，确认右下角状态栏显示的主题名和你预期一致 - 检查
settings.json中"workbench.colorTheme"的值是否精确匹配主题 ID（大小写、连字符、空格全敏感） - 例如
"Night Owl"不能写成"night-owl"或"NightOwl" - 不确定 ID？在扩展页点开主题详情，看
package.json里的id字段，或安装后查看~/.vscode/extensions/下对应文件夹名
真正难缠的不是配置写不对，而是多个配置层叠时谁赢谁输——.vscode/settings.json > 用户 settings.json > 扩展注入 > 主题内置。每次改完，记得用 Developer: Reload Window 而非简单保存，否则缓存可能卡住旧状态。
