vscode图标主题不会热重载，必须完全退出并重启或执行developer: reload window才能生效；原因包括配置id不匹配、远程环境未安装扩展、工作区设置覆盖、语言id识别错误、字体缺失或重复配置冲突。
文件图标主题不会热重载，必须手动触发或重启才能生效。 VSCode 的图标主题加载是启动时一次性完成的，修改 workbench.iconTheme、切换语言模式、安装/启用新扩展后，都不会自动刷新图标渲染——这是设计行为，不是 bug。
执行 Preferences: File Icon Theme 后图标没变
该命令只是写入配置，并不强制重绘资源管理器。常见原因包括：
- 你选的主题名和已安装扩展的 ID 不一致，比如选了
Material Icon Theme（显示名），但实际扩展 ID 是material-icon-theme；VSCode 会静默忽略无效值，回退到none - 当前窗口是远程开发（SSH/WSL）环境，但图标扩展只装在本地；远程端需单独安装并启用
- 工作区设置
.vscode/settings.json中存在"workbench.iconTheme": null或空字符串，它会覆盖用户级设置 - 状态栏右下角语言标识显示为
Plain Text，而图标主题只对javascript、json等语言 ID 生效，与文件后缀无关
settings.json 修改后图标仍不出现
直接编辑 JSON 并保存，VSCode 不会重新解析图标映射表。必须满足以下任一条件：
- 完全退出 VS Code（不是关闭窗口，而是从 Dock / 任务栏彻底退出进程），再重新打开
- 执行命令面板中的
Developer: Reload Window（快捷键Ctrl+R/Cmd+R），但注意：部分版本对图标缓存刷新不完整，仍需重启 - 确认扩展已启用：在扩展视图中搜索对应插件（如
vscode-icons），右上角齿轮图标点开 → 检查是否勾选「启用」，且未勾选「在远程中禁用」
图标显示为方块 □ 或问号 ?
这不是主题没加载，而是字体层缺失。VSCode 图标依赖 Nerd Fonts 渲染符号字形：
- Windows 用户需安装
FiraCode Nerd Font等补丁字体，并在设置中明确指定："editor.fontFamily": "'FiraCode Nerd Font', Consolas, monospace" - macOS 用户一般自带支持，但若使用自定义字体，需确保该字体包含
devicons字符集 - Linux 用户安装字体后必须运行
fc-cache -fv刷新系统字体缓存，否则 VSCode 读不到新字体 - 不要在
settings.json中同时写两个workbench.iconTheme，后者会静默覆盖前者，且无任何提示
最常被忽略的一点：图标主题和颜色主题之间没有联动逻辑。哪怕你刚切换了 Dracula Official 颜色主题，也得单独再执行一次 Preferences: File Icon Theme，否则图标永远停留在上一个状态。
