装完插件图标不显示是因为 VSCode 不自动启用图标主题,必须手动执行 Preferences: File Icon Theme 或 Icons: Activate Icons 才会写入 settings.json;工作区 settings.json 会静默覆盖全局配置,需检查并删除或注释 "workbench.iconTheme"。

vscode-icons 和 Material Icon Theme 是目前最常用、支持最全的两个文件图标插件。装完不显示图标,不是插件坏了,是 VSCode 默认不自动启用——必须手动触发一次激活操作,配置才会写进 settings.json。
为什么装完插件图标还是没变?
VSCode 坚决不自动启用任何图标主题,哪怕你刚点完“安装”。它只把插件下载好,等你明确选中一次才算数。
- 常见现象:
package.json、.gitignore还是空白文档图标,资源管理器里全是默认齿轮和文件夹 - 根本原因:没执行
Preferences: File Icon Theme或Icons: Activate Icons - 特别注意:
vscode-icons必须运行Icons: Activate Icons才会写入"workbench.iconTheme": "vscode-icons";而Material Icon Theme可以直接从命令面板选主题,但一样要手动点 - 检查方法:打开
settings.json(快捷键Ctrl+, → Open Settings (JSON)),确认里面有这行:"workbench.iconTheme": "vscode-icons"或"workbench.iconTheme": "material-icon-theme"
怎么给 .env.*、.prettierrc.* 这类多段后缀配图标?
Material Icon Theme 支持自定义映射,vscode-icons 也支持但需用 Icons: Enable All 开启高级规则,Minimal Icons 则完全不支持。
-
.env.*匹配的是.env.dev、.env.production,但不匹配.env.dev.local(二级点号超出 glob 范围) - 正确写法示例(加到
settings.json中):"material-icon-theme.files.associations": { ".env.*": "gear", ".prettierrc.*": "settings", ".eslintrc.*": "settings" } - 别写
*.test.js—— VSCode 不认这种通配;应该写.test.js(以点开头才被识别为扩展名) - 改完必须执行
Developer: Reload Window,尤其在 Dev Container 或 Codespaces 里,热更新不生效
工作区 settings.json 会静默覆盖全局设置
这是最容易被忽略的坑:你在某个项目根目录下建了 .vscode/settings.json,里面写了 "workbench.iconTheme": "none",那这个工作区就永远看不到图标,且界面设置里完全不提示有这行配置。
- 排查方式:打开命令面板,输入
Preferences: Open Workspace Settings (JSON),看是否有workbench.iconTheme - 优先级顺序:工作区 > 用户设置 > 默认值
- 临时验证:关掉当前窗口,用
code /path/to/project命令行新开一个纯净窗口,对比图标是否恢复 - 如果确实被覆盖,删掉或注释掉工作区里的那一行即可
真正卡住人的从来不是“怎么装”,而是“为什么装了没反应”——多数时候就是漏了那一次手动激活,或者被工作区配置悄悄劫持了。


















