Material Icons插件安装失败或图标不生效，需检查是否启用主题、排除其他图标主题覆盖、重启VSCode；图标错乱多因DPI/缩放冲突，应调整系统缩放并确认workbench.iconTheme值为"material-icon-theme"；可配置files.associations精简图标，搭配暗色主题时建议调低saturation和opacity。
Material Icons插件安装失败或图标不生效
VSCode里装了 Material Icon Theme 却没看到文件图标？大概率是主题没启用，或者被其他图标主题覆盖。VSCode只允许激活一个图标主题，即使你装了多个，也得手动选中它。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入Preferences: File Icon Theme，回车后从列表里选中Material Icon Theme - 检查是否误启用了
None或其他图标主题（比如Minimal），它们会直接屏蔽所有图标 - 如果安装后图标仍是默认样式，尝试重启 VSCode——部分版本不会热加载图标主题变更
图标显示错乱、文件夹变问号或图标重叠
这是字体渲染和图标映射冲突的典型表现，常见于 Windows 上启用了「自定义 DPI 缩放」或 macOS 启用了「自动缩放分辨率」的设备。Material Icons 依赖 VSCode 内置的图标字体（vscode-icons 字体族），一旦系统字体 fallback 失败，就会退化为方块、问号或重叠文字。
- 在 VSCode 设置中搜索
workbench.iconTheme，确认值为"material-icon-theme"（注意不是"Material Icon Theme"这个显示名） - 关闭「设置 → Window → Zoom Level」的自定义缩放，改用系统级缩放（尤其是 Windows 的「更改文本、应用等项目的大小」设为 100% 或 125%，避免 110%、115% 这类非整数倍）
- 如仍异常，可临时在
settings.json中添加："material-icon-theme.folders.color": "#4285f4", "material-icon-theme.files.color": "#34a853"
强制指定颜色，有助于判断是颜色未生效还是图标根本没加载
想精简图标数量、禁用特定类型文件的图标
Material Icons 默认开启全部文件类型映射，但像 .gitignore、.env、.editorconfig 这类配置文件图标容易干扰视觉节奏。它支持按需关闭，不需要删插件或改源码。
- 在设置中搜索
material-icon-theme.files.associations，点击「Edit in settings.json」，添加类似这样的映射："material-icon-theme.files.associations": { ".env": "file", ".gitignore": "file" }—— 把对应文件强制设为通用file图标（即空白页图标） - 若想彻底隐藏某类图标（比如所有隐藏文件），目前不支持全局开关，但可设为透明色：
"material-icon-theme.files.color": "transparent"
（慎用，会影响所有文件） - 注意：修改
files.associations后无需重启，保存即生效；但新增的扩展名（如.astro）需确保该语言 ID 已被 VSCode 识别，否则映射无效
与其他主题（如 One Dark Pro、SynthWave）搭配时颜色打架
Material Icons 自带浅色/深色适配逻辑，但它依赖 VSCode 当前工作台亮度（workbench.colorTheme）做判断，而不是实际背景色。当你用高对比度暗色主题（比如 SynthWave '84）时，图标可能因误判为“亮色模式”而显示浅蓝底色，显得突兀。
- 优先使用插件内置的暗色优化开关：
"material-icon-theme.saturation": 0.7, "material-icon-theme.opacity": 0.9
降低饱和度和轻微透明，能柔化冲突 - 不要手动改
folders.color为纯白或纯黑——这会让图标在深色背景下“消失”，建议用灰阶色值如#aaaaaa或主题主色的低饱和变体 - 某些主题（如
GitHub Dark）会重写icon.foregroundCSS 变量，此时 Material Icons 会失效；此时只能关掉该主题的图标相关 override，或换用更轻量的主题
settings.json 手动覆盖才真正可控。 
