VSCode 主题与图标包需分别安装并手动启用，配置须通过 settings.json 显式指定字段，注意引号和字段名；工作区设置会静默覆盖全局配置，需检查状态栏及用户/工作区两份 JSON 文件。
VSCode 的主题和图标包不是“装上就完事”的配置，它们的生效逻辑、优先级和常见冲突点必须理清，否则你会反复看到图标不显示、颜色错乱或设置不生效。
主题和图标包必须分开安装，且来源要可信
VSCode 的 Color Theme（颜色主题）和 File Icon Theme（文件图标主题）是两个独立扩展类型，不能混用。官方市场里有些“全能主题”实为打包合集，但内部仍分属两类——安装时务必确认扩展详情页的 Category 标签是否明确写着 “Color Theme” 或 “Icon Theme”。
- 推荐从 VS Code 官方扩展市场搜索关键词：
One Dark Pro（主题）、Material Icon Theme（图标），避免使用名称模糊如 “Cool Theme++” 类非标准命名的扩展 - 第三方源（如 GitHub 直链安装）可能绕过 VS Code 的激活校验，导致图标不渲染或主题无法保存到
settings.json - 禁用所有主题/图标扩展后重启 VS Code，再逐个启用，可快速定位冲突源
主题与图标的启用必须通过设置界面或 settings.json 显式指定
仅安装扩展 ≠ 启用。VS Code 不会自动激活刚装好的主题或图标，必须手动选择。最稳妥的方式是编辑 settings.json，而非依赖 GUI 点选——GUI 有时会写入错误字段或遗漏引号。
- 正确写法（注意引号和字段名）：
"workbench.colorTheme": "One Dark Pro", "workbench.iconTheme": "material-icon-theme"
- 错误写法示例：
"theme": "One Dark Pro"（字段名不存在）、workbench.iconTheme: material-icon-theme（缺引号，JSON 解析失败） - 如果改了
settings.json没反应，检查右下角状态栏是否显示当前启用的主题名；若显示“Default Dark+”，说明配置未生效或被工作区设置覆盖
工作区设置会覆盖用户级主题，且无视觉提示
当你在某个项目文件夹里打开 VS Code，它可能读取该目录下的 .vscode/settings.json，其中若包含 workbench.colorTheme 字段，就会强制覆盖你全局设置的主题——而界面不会弹窗、也不会高亮提醒。
- 排查方式：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Preferences: Open Settings (JSON)，对比用户设置和工作区设置两份文件 - 常见诱因：团队项目自带
.vscode目录、脚手架工具（如create-react-app）自动生成的配置、或某次误操作保存了工作区设置 - 临时解决：在工作区设置中删掉对应字段；长期建议统一团队规范，或用
settings sync同步时排除workbench.*Theme
真正卡住人的往往不是“怎么装”，而是“为什么没变”——主题和图标依赖配置加载顺序、作用域层级和 JSON 语法严谨性，任何一个环节出偏差，视觉就回退到默认灰扑扑的状态。
