vscode主题搜不到或不生效，主因是配置覆盖、状态禁用或工作区锁死；需检查扩展是否禁用、主题id拼写是否准确、settings.json中colortheme值是否正确、workbench.colorcustomizations是否干扰，并执行reload window而非重启。
VSCode 主题搜不到，90% 不是主题下架或网络问题，而是被配置覆盖、状态禁用或工作区锁死——直接重装或换镜像源往往白忙。
主题在 Extensions 视图里根本没出现？先确认是否被禁用或未激活
VSCode 的主题扩展（如 catppuccin.catppuccin 或 dracula-theme.theme-dracula）安装后默认不自动启用，尤其从 VSIX 手动安装、升级失败或冲突时，会卡在“已安装但禁用”状态。
- 打开扩展视图（
Ctrl+Shift+X），搜索主题名，看右下角是否有 Disabled 标签；若有，点击右侧齿轮图标 → Enable - 某些主题（如
one-monokai）需额外触发激活命令：按Ctrl+Shift+P输入One Monokai: Activate Theme并回车 - 禁用所有其他同类型主题扩展（比如同时装了
material-theme和synthwave-x-flux），避免注册表冲突导致部分主题无法加载
主题 ID 拼写错误或大小写不一致？检查 settings.json 里的 colorTheme 值
VSCode 主题生效依赖精确匹配的 ID 字符串。ID 错一个字母、多一个空格、大小写不符（如 catppuccin-mocha 写成 catppuccin/Mocha），都会静默失败。
- 执行
Preferences: Open Settings (JSON)（Ctrl+Shift+P输入） - 查找
"workbench.colorTheme"字段，确认值是主题发布页明确标注的 ID（例如"catppuccin-mocha"，不是"Catppuccin Mocha"） - 如果项目根目录有
.vscode/settings.json，它优先级高于用户设置——打开它，同样检查workbench.colorTheme是否被强制覆盖
主题装上了但颜色完全没变？重点排查 workbench.colorCustomizations 干扰
这是最隐蔽也最高频的原因：workbench.colorCustomizations 是全局硬覆盖机制，一旦存在（哪怕只是空对象 {}），就会彻底屏蔽主题自带的颜色逻辑。
- 在
settings.json中搜索workbench.colorCustomizations - 临时注释或删除整段（包括键名和花括号），保存后按
Ctrl+K Ctrl+T切换回同一主题测试 - 若立刻生效，说明就是它在“劫持”。后续如需微调，请改用主题自身支持的配置项（如
catppuccin.colorScheme），而非全局覆盖
重启无效？必须 Reload Window 而非简单关闭再开
VSCode 主题系统依赖运行时注册，单纯关窗口再打开，可能只复用旧缓存，主题注册表并未刷新。
- 务必执行
Developer: Reload Window（Ctrl+Shift+P输入后回车）——这是强制卸载并重载全部主题扩展的唯一可靠方式 - 仍不生效？终端执行
code --disable-extensions启动纯净版，排除第三方插件干扰（尤其是旧版 Material Theme、Custom CSS 等） - 极少数情况（如 Windows 权限异常），主题文件实际未解压到
%USERPROFILE%\.vscode\extensions\下对应文件夹，可手动检查该路径是否存在目标主题子目录
