material icon theme 和 vscode-icons 是最可靠、覆盖最全的两个图标主题:前者需手动执行 preferences: file icon theme 激活并支持精细文件关联映射,后者依赖 icons: activate icons 命令启用且图标更紧凑;minimal icons 极简黑白风格但自定义能力弱,不支持 files.associations。

Material Icon Theme 和 vscode-icons 是目前最可靠、覆盖最全的两个选择,其他图标包要么支持语言少,要么加载慢或适配差。
Material Icon Theme:默认启用后仍需手动激活
装完插件图标不显示,不是插件坏了,是 VSCode 坚决不自动启用图标主题。必须执行 Preferences: File Icon Theme 并选中 Material Icon Theme,否则 settings.json 里写好 "workbench.iconTheme": "material-icon-theme" 也白搭。
- 常见错误现象:
.env.local、.prettierrc.cjs显示普通文件图标,不是齿轮或设置图标 - 使用场景:需要区分多段后缀的配置文件
- 解决办法:在
settings.json中加"material-icon-theme.files.associations",例如:"material-icon-theme.files.associations": { ".env.*": "gear", ".prettierrc.*": "settings" } - 参数差异:
.env.*是 glob 模式,只匹配一级(.env.dev有效,.env.dev.local不会命中) - 容易踩的坑:
*.test.js写法无效;正确写法是".test.js"(必须以点开头)
vscode-icons:老牌稳定,但启用流程稍多一步
它不像 Material Icon Theme 那样靠命令面板一键启用,而是依赖 Icons: Activate Icons 命令来写入配置并触发重载。漏掉这步,图标照样不出现。
- 常见错误现象:安装完看到资源管理器还是小方块图标
- 使用场景:小屏设备、文件密集型项目(图标更紧凑,视觉干扰少)
- 实操建议:执行
Icons: Activate Icons后,检查settings.json是否已自动添加"workbench.iconTheme": "vscode-icons" - 性能影响:启用
Icons: Enable All后图标种类变多,但对启动速度无明显拖累 - 容易踩的坑:没执行
Developer: Reload Window,尤其在远程开发(Dev Container / Codespaces)中,配置不会热更新
Minimal Icons:适合极简党,但自定义能力弱
它主打“不抢眼”,黑白灰线性图标,几乎不带颜色和填充,适合写文档、教学或长期盯屏的场景。但它不支持 files.associations 这类精细映射,想给 .env 加锁形图标?做不到。
- 使用场景:深色 UI 主题下追求界面统一,或反感任何颜色干扰
- 实操建议:启用后若文件夹没动画,需手动加
"minimal-icons.enableFolderAnimation": true到settings.json - 兼容性提示:不识别
.jsonc等新后缀,VSCode 1.80+ 才原生支持,旧版得自己映射".jsonc": "json" - 容易踩的坑:试图用 CSS 注入强行改它的图标大小或颜色——会破坏暗色模式适配,且每次更新可能失效
真正难搞的不是装哪个插件,而是搞清「谁在控制图标」:全局 settings.json、工作区 .vscode/settings.json、甚至 Dev Container 的配置都可能互相覆盖。一个 "workbench.iconTheme" 被多处定义,最终生效的往往是你没注意到的那一行。











