vscode图标主题需手动启用：安装material icon theme等扩展后，必须通过命令面板执行preferences: file icon theme并选择对应id（如material-icon-theme），同时确保settings.json中workbench.icontheme值精确匹配扩展id，且系统已安装nerd fonts以避免方块显示。
Preferences: File Icon Theme 命令必须手动触发
装完 Material Icon Theme 或 vscode-icons 后，图标不会自动出现。VSCode 不会因为扩展安装就切换图标主题，哪怕你刚启用了同名的颜色主题。必须主动执行命令才能激活。
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入并选择 Preferences: File Icon Theme，回车后从列表中选中已安装的图标包（例如 material-icon-theme）。注意名称大小写和连字符——material-icon-theme 是扩展 ID，不是显示名。
- 如果列表为空，检查扩展面板里该插件是否为 “Enabled” 状态
- 别同时启用多个图标主题扩展：后者会静默覆盖前者，且 VSCode 不报错
- 选中后立即生效，无需重启 VSCode
settings.json 中 workbench.iconTheme 的值必须精确匹配扩展 ID
手动编辑配置时，"workbench.iconTheme" 的字符串值必须与扩展注册的 ID 完全一致。常见错误包括：
-
"workbench.iconTheme": "Material Icon Theme"❌（这是显示名） -
"workbench.iconTheme": "material-icons"❌（少连字符或拼错） -
"workbench.iconTheme": "material-icon-theme"✅（正确 ID，对应官方扩展equinusocio.vsc-material-theme）
这个配置优先级低于工作区设置：若项目根目录下有 .vscode/settings.json，它会覆盖用户级配置，需在里面也补上该字段。
图标显示为方块 □？本质是字体不支持
很多图标主题（尤其是 vscode-icons）依赖 Nerd Fonts 提供的符号字形。系统缺字体，VSCode 就 fallback 到空白方块或问号。
- Windows 用户：下载安装
FiraCode Nerd Font，再在 VSCode 设置中配"editor.fontFamily": "'FiraCode Nerd Font', Consolas, 'Courier New', monospace" - macOS 用户：可用
brew tap homebrew/cask-fonts && brew install --cask font-fira-code-nerd-font - Linux 用户：手动安装字体后运行
sudo fc-cache -fv刷新缓存
装完字体后，记得重启 VSCode 或用 Developer: Reload Window 刷新窗口。
文件图标没变？先确认是否被工作区设置或插件覆盖
即使全局配置正确，图标仍可能不生效。常见干扰源：
-
.vscode/settings.json里写了"workbench.iconTheme": null或空字符串 - Peacock 插件等会动态修改主题配置，可能覆盖
workbench.iconTheme - 远程开发（SSH/Containers）环境下，图标主题需在远程端单独安装并启用
- 按
Ctrl+Shift+P运行Developer: Toggle Developer Tools，在 Console 里搜icon，出现Failed to load icon theme就说明路径或 ID 写错了
最稳的验证方式：右下角状态栏点击齿轮图标，看是否显示 “Workspace Settings”；如果显示，说明当前工作区设置了独立配置，得进去检查或覆盖。
