material icon theme 安装后图标不显示，主因是 vscode 未启用该图标主题；需通过命令面板选择“preferences: file icon theme”并指定 material icon theme，检查启用状态、工作区设置、文件/文件夹关联及高 dpi 兼容性。
Material Icon Theme 安装后图标不显示
不是插件没装好，大概率是 VSCode 没启用图标主题。装完 Material Icon Theme 只是把图标文件放进了扩展目录，但默认仍用系统自带的空心文件夹图标。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Preferences: File Icon Theme，回车 - 在弹出列表中选择
Material Icon Theme（注意不是Material Theme或其他变体） - 如果列表里没有，说明插件未正确激活：检查插件页是否显示“已启用”，或重启 VSCode
- 某些工作区可能覆盖了全局设置——确认右下角状态栏没显示“Workspace”图标，否则需在该工作区设置中单独启用
图标对特定文件类型不生效（比如 .env、.yml、自定义后缀）
Material Icon Theme 默认只映射常见文件类型，冷门或项目私有后缀需要手动关联，否则显示为通用文档图标。
- 打开设置（
Ctrl+,），搜索material-icon-theme.files.associations - 点击“在 settings.json 中编辑”，添加类似这样的映射：
"material-icon-theme.files.associations": {
".env": "config",
".yml": "yaml",
".myconf": "config"
}
- 右侧值必须是主题已定义的图标类型（如
config、yaml、javascript），不能随意写；可查官方文档的icon name列表 - 改完保存，无需重启，图标通常立即刷新；若无效，试试关闭再打开资源管理器面板
文件夹图标混乱：src 和 lib 都显示同一个图标
VSCode 文件夹图标靠文件夹名匹配，但 Material Icon Theme 对常见名（如 src、lib、test）有默认规则，容易误匹配。
- 检查是否启用了
material-icon-theme.folders.color或folders.theme等高级配置，它们会干扰基础匹配逻辑 - 想让
src显示火箭图标、lib显示书本图标？直接在settings.json中指定：
"material-icon-theme.folders.associations": {
"src": "src",
"lib": "library"
}
-
src和library是主题内置的文件夹图标标识符，大小写敏感，不能写成Src或LIB - 如果项目里有嵌套结构（如
packages/my-lib），仅配lib不会生效——得配my-lib或启用通配（主题不支持正则，只能列具体名）
换主题后图标变模糊 / 高 DPI 屏幕显示异常
这不是图标本身问题，而是 VSCode 渲染层和 SVG 图标缩放之间的兼容性缺陷，尤其在 Windows + 外接高分屏场景下明显。
- 先确认 VSCode 是否运行在缩放正确的上下文中：右键快捷方式 → 属性 → 兼容性 → 勾选“替代高 DPI 缩放行为”，模式选“应用程序”
- 禁用硬件加速有时能缓解：
code --disable-gpu启动，或在settings.json加"window.enableNativeTabs": false（副作用是标签页变普通样式） - 更稳妥的做法是降级到 v4.12.1 版本（最后稳定支持 SVG 清晰渲染的版本），新版为了适配新图标格式牺牲了部分缩放精度
