material icon theme 图标不显示是因为未手动启用图标主题且未重载窗口；需通过命令面板选择图标主题并重载，再配置文件/文件夹关联和禁用冲突插件。
装完 Material Icon Theme 图标不显示？不是插件坏了，而是 VSCode 默认压根不会自动启用它——必须手动指定，否则永远是空心文件夹和默认文档图标。
怎么确认 Material Icon Theme 已启用
很多人在 settings.json 里写了 "workbench.iconTheme": "material-icon-theme" 就以为搞定了，结果资源管理器还是老样子。关键漏了一步：VSCode 的图标主题开关是独立于配置文件的运行时状态。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Preferences: File Icon Theme并回车 - 在弹出列表中**必须选中
Material Icon Theme**（注意不是Material Theme，后者是 UI 颜色主题） - 如果列表里压根没这个选项，说明插件没激活：去扩展页检查是否显示“已启用”，或者重装一次再试
- 选完后右下角会提示“Reload Window”，点它——不重载，配置只是躺在文件里，不会生效
为什么 .env.local、.prettierrc.cjs 这类文件没图标
Material Icon Theme 默认只识别标准后缀（如 .js、.py），对多段后缀（.env.local）或带配置前缀的文件（.prettierrc.cjs）只取最后一段匹配，前面部分被忽略。
- 解决方法是手动加映射，在
settings.json中添加"material-icon-theme.files.associations" - 正确写法：
".env.local": "gear"或".prettierrc.cjs": "settings"（右侧值必须是主题内置图标名，不能瞎写） - 支持 glob 模式，比如
".env.*": "gear"，但*.test.js无效——它只认以.开头的扩展名 - 改完保存，图标通常立即刷新；若无效，重载窗口比重启更轻量
src、lib、packages 这些文件夹图标乱套了怎么办
文件夹图标靠名字硬匹配，但 material-icon-theme.folders.associations 和 folders.color 这两个设置容易互相干扰，导致 src 显示成普通文件夹、lib 显示成测试图标。
- 先关掉
material-icon-theme.folders.color（它会让所有文件夹染色，覆盖语义图标） - 想让
src显示火箭、lib显示书本，就明确配："src": "src"、"lib": "library"（大小写敏感，不能写成Src） - 嵌套文件夹如
packages/my-lib不会自动匹配lib，得单独写"my-lib": "library"或列全路径 - 别用正则或通配符——主题不支持，写了也白搭
图标模糊、发灰、颜色错位的真正原因
这不是插件 bug，而是 VSCode 渲染层和 SVG 图标缩放之间的兼容性问题，尤其在高 DPI 屏幕（比如 Windows 外接 4K 屏）上特别明显。
- 禁用所有其他图标插件（如
vscode-icons），它们会互相覆盖，导致图标变方块或消失 - 不要用自定义 CSS 强行调图标大小或颜色——升级后失效，还可能破坏暗色模式适配
- 系统缩放 > 125% 时，可临时按
Ctrl + -缩小编辑器验证是否为渲染问题 - 检查
workbench.iconTheme是否被设为null或空字符串（常见于工作区.vscode/settings.json覆盖）
最常被跳过的动作是重载窗口，其次是混淆 File Icon Theme 和 Color Theme 的命令入口——这两个开关完全独立，装对插件 ≠ 自动启用，少一步图标就永远不出来。
