装完图标插件没变化，是因为VSCode不自动启用——必须手动执行Preferences: File Icon Theme命令选择主题，并确保settings.json中"workbench.iconTheme": "material-icon-theme"配置正确且未被工作区设置覆盖。
装完插件图标没变，不是插件坏了，是 VSCode 坚决不自动启用——你必须手动选一次主题，workbench.iconTheme 才会写进配置里，否则所有后续自定义都无效。
执行 Preferences: File Icon Theme 命令才能激活主题
VSCode 安装扩展只下载资源，不写配置、不激活主题。很多人卡在这一步：资源管理器里还是默认文档图标。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Preferences: File Icon Theme - 从列表中选
Material Icon Theme（注意不是Material Theme，后者是 UI 主题；也不是None或Seti） - 右下角状态栏应出现
Material Icon Theme字样——没出现说明没生效 - 如果命令面板里根本没列出这个主题，去扩展面板检查：
material-icon-theme是否已安装且启用（ID 必须完全一致）
检查 workbench.iconTheme 配置值是否正确
这个字段必须显式写在用户设置或工作区 .vscode/settings.json 中，值必须和插件 ID 严格匹配。
- 打开
settings.json（快捷键Ctrl+,→ 右上角花括号图标） - 添加这一行：
"workbench.iconTheme": "material-icon-theme" - 别写成
"material-icon"、"MaterialIconTheme"或带空格的"material-icon-theme " - 多根工作区下，某个子文件夹的
.vscode/settings.json若含"workbench.iconTheme": null，该文件夹图标会强制退回到默认样式，且界面不提示
让 .env.local、vite.config.ts 这类文件显示图标
Material Icon Theme 默认只覆盖常见后缀（如 .js、.json），自定义配置文件需手动映射，但字段名和图标名都严格绑定扩展本身。
- 在
settings.json中添加material-icon-theme.files.associations字段 - 键名是文件名或通配符（如
"*.env.local"），不能带路径；值必须是该主题实际支持的图标标识符（查其 GitHub README 的 icon list，写成tune而非tune-icon） - 示例：
"*.env.local": "tune"、"vite.config.ts": "typescript"、".prettierrc.*": "settings" - 改完保存后通常立即生效；若没反应，优先执行
Developer: Reload Window，比重启 VSCode 快得多
图标显示为方块、问号或颜色异常？排查渲染冲突
这不是插件问题，而是字体 fallback 失败或缩放干扰导致的渲染层失效。
- 禁用所有其他图标主题插件（比如
vscode-icons），二者冲突会互相覆盖 - 确认系统 DPI 缩放设为整数倍（100% 或 125%），避免 110%、115% 等非整数倍——VSCode 渲染层对非整数缩放支持差，图标易发虚或错位
- 临时调低 VSCode 缩放（
Ctrl + -）验证是否为缩放问题 - 不要手动修改插件目录下的
icons文件夹，升级后会被清空
最容易被忽略的是：改了 files.associations 却没确认 workbench.iconTheme 已正确写入，或者被工作区设置静默覆盖。图标主题的生效链条非常脆弱，漏掉任意一环都会退回默认样式。
