先确认是否启用,vscode不会自动激活图标主题;需通过命令面板执行preferences: file icon theme并选择material icon theme,再点击reload window生效,否则settings.json配置无效。

Material Icon Theme 安装后图标不显示?先确认是否启用
VSCode 不会自动激活图标主题,装完 Material Icon Theme 只是把资源放进编辑器,不手动启用就等于没装。常见错误现象是:扩展已安装、文件树仍是默认方块或空白图标,甚至 macOS 上出现乱码方块。
必须走命令面板流程:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并执行
Preferences: File Icon Theme - 从列表中选中
Material Icon Theme,回车 - 看到右下角弹出“Reload Window”提示,**必须点它**,或手动执行
Developer: Reload Window
跳过重载步骤,settings.json 里即使有 "workbench.iconTheme": "material-icon-theme" 也不会生效——VSCode 启动时只读取已激活的主题配置。
为什么 .env.local、.prettierrc.cjs 这类文件没图标?
Material Icon Theme 默认只识别单段后缀(如 .js、.json),对多点后缀(.env.local、.eslintrc.js)仅匹配最后一段(local、js),前面修饰部分被忽略。这不是 bug,是设计逻辑。
解决方法是用 files.associations 手动映射:
- 运行
Preferences: Open Settings (JSON) - 在
settings.json中添加:
"material-icon-theme.files.associations": {
".env.*": "config",
".prettierrc.*": "config",
".eslintrc.*": "config",
".gitignore": "git"
}
注意:.env.* 是 glob 模式,不是正则;* 只匹配一级,.env.dev.local 不会被 .env.* 覆盖,需单独加 ".env.dev.local": "config"。
图标颜色太艳/太淡?别用 CSS 注入调色
有人想通过自定义 CSS 强行改图标颜色或缩放,结果导致 VSCode 升级后图标错位、暗色模式失效、甚至拖慢启动速度。官方明确不支持这种 hack 方式。
正确做法是用插件原生设置项:
- 在设置搜索框输入
material icon - 调整这些开关:
Material Icon Theme: Folders Color —— 控制文件夹图标是否着色(关掉更清爽)Material Icon Theme: Saturation —— 数值范围 0–1,0.7 是较平衡的推荐值Material Icon Theme: Opacity —— 建议设为 0.95,避免全透明导致图标发虚
这些参数直接作用于 SVG 图标渲染层,兼容性好,VSCode 1.80+ 全支持。
和 Material Theme 颜色主题一起用,要注意什么?
Material Theme(颜色主题)和 Material Icon Theme(图标主题)是两个独立扩展,作者不同、配置分离、更新节奏也不一致。容易踩的坑:
- 装了
Material Theme但没装material-icon-theme→ 文件树还是默认图标 - 装了
material-icon-theme但settings.json里"workbench.colorTheme"写的是"Default Dark+"→Material Theme颜色不生效,但图标可能正常(因为图标不依赖颜色主题) - 混用非主干分支,比如
Material Theme Palenight-Ocean→ VSCode 1.85+ 报Cannot read property 'tokenColors' of undefined
建议只保留官方维护的主干版本:Material Theme(PKief)、Material Icon Theme(PKief),其他带 -Vivid、-Ocean 后缀的社区变体,2026 年起已基本停止同步更新。











