VSCode装完主题或图标包不生效，必须手动启用：按Ctrl+K Ctrl+T选颜色主题，或Ctrl+Shift+P输入Preferences: File Icon Theme选图标主题；检查settings.json中workbench.colorTheme和workbench.iconTheme是否被覆盖为null或空字符串。
装完插件不生效，八成是没手动启用主题或图标主题——VSCode 不会自动切换，必须显式指定。
怎么安装并启用颜色主题（theme）
颜色主题控制编辑器整体配色，比如背景色、语法高亮、侧边栏颜色等。安装后必须主动启用，否则还是默认的 Light/Dark 主题。
- 打开扩展面板：
Ctrl+Shift+X（Windows/Linux）或Cmd+Shift+X（macOS） - 搜索主题名，例如
Dracula、One Dark Pro、Nord，确认作者和下载量，避免山寨版本 - 点击“Install”，完成后必须手动启用：按
Ctrl+K Ctrl+T（macOS 是Cmd+K Cmd+T），从弹出列表选中刚装的主题 - 如果快捷键没反应，说明可能被工作区设置覆盖：打开
settings.json，检查是否有"workbench.colorTheme"被设为null或空字符串
为什么装了 vscode-icons / Material Icon Theme 还是没图标
图标主题和颜色主题完全独立，装插件 ≠ 启用图标。VSCode 默认使用内置 vs-seti（就是那个空白方块+小箭头），哪怕你装了 10 个图标插件，不指定就永远不显示。
- 启用方式只有两种：
Ctrl+Shift+P→ 输入Preferences: Configure Icons→ 选目标主题；或手动在settings.json中写入"workbench.iconTheme": "material-icon-theme" - 常见主题 ID：
vscode-icons对应"vscode-icons"，Material Icon Theme对应"material-icon-theme"，大小写和连字符不能错 - Linux 下用 Snap 安装的 VSCode 可能因沙盒限制读不到图标字体，建议改用
.deb或官方tar.gz版本 - 工作区级
settings.json会覆盖用户级设置，图标消失时优先检查当前项目根目录下的.vscode/settings.json
background 插件配置图片路径的坑
vscode-background（或 shalldie.background）支持本地/远程图，但路径格式极易出错，尤其本地文件。
- 本地图片必须用
file://协议，且路径需完整、无空格、无中文（或 URL 编码）。Windows 示例："file:///C:/Users/xxx/Pictures/bg.jpg"；macOS/Linux："file:///home/xxx/Pictures/bg.png" - 直接填相对路径（如
"./bg.jpg"）或纯文件名（如"bg.jpg"）一定失败 - 透明度推荐设为
0.1–0.4，设太高会遮挡代码；全屏背景需额外配置"background.fullscreen"对象，仅配"background.editor"只作用于编辑区 - 插件启用后必须重启 VSCode 或执行命令
Background: Reload，否则图片不加载
settings.json 多层覆盖时怎么排查
VSCode 设置分三层：用户级（全局）、工作区级（项目根目录 .vscode/settings.json）、远程/容器级。图标或主题失效，大概率是某一层写了 "workbench.iconTheme": null 或 "workbench.colorTheme": ""。
- 按
Ctrl+,打开图形化设置，右上角点击“打开设置 (JSON)”可同时查看所有层级的settings.json - 搜索
iconTheme和colorTheme，确认值是否为合法字符串（如"material-icon-theme"），而不是null、""或拼写错误 - 工作区设置优先级高于用户设置，删掉项目里多余的
.vscode/settings.json常能快速验证问题根源
真正卡住人的从来不是“怎么装”，而是“谁在悄悄覆盖你的设置”。打开 settings.json 看一眼 workbench.iconTheme 和 workbench.colorTheme 的实际值，比反复重装插件管用十倍。
