先确认是否启用：vscode不会自动启用图标主题，必须通过命令面板执行“preferences: file icon theme”并选择“material icon theme”，同时检查扩展状态为“已启用”，且settings.json中workbench.icontheme值为"material-icon-theme"。
装了 Material Icon Theme 扩展但没图标？先确认是否启用
VSCode 不会自动启用任何图标主题，哪怕你刚点完「安装」。扩展只是把图标资源放进来，真正生效得靠 workbench.iconTheme 配置项被正确设置并激活。
常见错误现象：settings.json 里写了 "workbench.iconTheme": "material-icon-theme" 却没反应，大概率是扩展没启用，或者值写错了——注意 ID 必须是 material-icon-theme，不是 Material Icon Theme 或 material-icon。
- 打开命令面板（
Ctrl+Shift+P），输入Preferences: File Icon Theme，回车后选Material Icon Theme - 检查扩展面板里该扩展状态是不是「已启用」，不是「已安装」
- 确认
settings.json中该字段值为"material-icon-theme"，且没有被工作区设置（.vscode/settings.json）覆盖
为什么 .env、Dockerfile 这类文件还是默认图标？
Material Icon Theme 默认只映射主流后缀，像 .env、Dockerfile、.astro 等需要手动关联图标名。它不报错、也不提示缺失，就默默 fallback 到通用文档图标。
图标名必须是主题实际支持的，不能随便写。比如 "tune" 对应齿轮图标，"docker" 对应鲸鱼图标——这些名字得查扩展的 Contributions 标签页或 GitHub 的 iconDefinitions 列表。
- 在
settings.json中添加字段："material-icon-theme.files.associations" - 示例配置：
"material-icon-theme.files.associations": { "*.env": "tune", "Dockerfile": "docker", "*.astro": "astro" } - 改完保存，不用重启，资源管理器会立刻刷新；如果没变，执行
Developer: Reload Window
自定义文件夹图标时配错字段名，整个配置就失效
Material Icon Theme 的文件夹关联字段是 material-icon-theme.folders.associations，不是 folders.associations 或 vsicons.associations.folders。拼错字段名不会报错，但 VSCode 直接忽略整段配置。
而且它的值必须是主题内置的文件夹图标名，比如 "src"、"dist"、"test"，不是任意字符串。写成 "mylib" 就不会显示图标。
- 正确写法：
"material-icon-theme.folders.associations": { "src": "src", "config": "config", "migrations": "database" } - 图标名大小写敏感，
"Database"≠"database" - 想查全量支持的文件夹图标名？打开扩展详情页 → 点「Contributions」→ 拉到
iconDefinitions区域找folder-xxx类型
图标模糊、颜色异常或部分不显示？别急着重装
这类问题八成和 DPI 缩放、字体渲染或沙盒权限有关，跟图标包本身关系不大。尤其在 Linux Snap 版、Windows 高 DPI 设置下，图标字体（如 material-icons.ttf）可能加载失败，导致 fallback 到系统默认方块。
Material Icon Theme 启动时还会弹更新提示，如果被拦截或卡住，也可能阻塞图标加载流程。
- Linux 用户优先换用
.deb或官方 tarball 安装包，避开 Snap 沙盒限制 - Windows 高 DPI 下：右键 VSCode 快捷方式 → 属性 → 兼容性 → 勾选「替代高 DPI 缩放行为」
- 关掉烦人的弹窗：
"material-icon-theme.showUpdateMessage": false - 如果图标全变成空白方块，先检查
settings.json是否有"workbench.iconTheme": null或空字符串
最容易被忽略的是：图标主题的启用状态不保存在 settings.json 里，而是存在 VSCode 的用户元数据中。迁移配置或重装系统时，光复制 JSON 文件，图标主题会直接消失——得一并导出已启用的扩展列表。
