material icon theme 安装后图标不显示，需手动启用：打开命令面板输入“preferences: file icon theme”并选择该主题；隐藏文件如.env需在settings.json中配置files.associations；node_modules等可设folders.associations为"folder"禁用图标；渲染异常时检查fontaliasing设置及字体资源加载。
Material Icon Theme 安装后图标不显示？先确认激活状态
VSCode 里装了 Material Icon Theme 却没看到文件图标，大概率是它没被真正启用。插件安装 ≠ 主题生效 —— VSCode 的图标主题和颜色主题是分开管理的。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入Preferences: File Icon Theme - 在下拉列表中选择
Material Icon Theme（注意不是Material Theme，后者是颜色主题） - 如果列表里没有，说明插件没正确安装：去 Extensions 页面搜
material icon theme，认准作者是Philipp Kief，点 Install 再重试
常见错误：装了同名但非官方的精简版或 fork 版，图标集不全，甚至会报 Cannot read property 'iconDefinitions' of undefined 错误。
怎么让 .env、.gitignore 这类隐藏文件也显示图标？
默认情况下，Material Icon Theme 不会给以 . 开头的文件加图标（比如 .env、.prettierrc），这是刻意设计的兼容性策略 —— 避免干扰用户对“隐藏文件”的视觉判断。
要开启，得手动改设置：
- 打开设置（
Ctrl+,），搜索material-icon-theme.showWelcomePage→ 关掉它（首次启用时弹窗很烦，但和图标无关） - 搜索
material-icon-theme.hidesFolders，把它设为false（影响文件夹，顺带一提） -
关键一步：在
settings.json里加这段：
"material-icon-theme.files.associations": {
".env": "tune",
".gitignore": "git",
".prettierrc": "config",
".eslintrc.js": "eslint"
}
tune、git、config 是图标 ID，不是随便写的；ID 列表见插件 GitHub 的 src/icons/fileIcons.ts。填错会导致图标回退成默认问号。
项目里 node_modules 图标太花？可以单独关掉
node_modules 文件夹默认用彩色齿轮图标，但里面几万文件一展开，图标渲染压力大，还容易卡顿。更实际的做法是让它「不显示图标」，只保留折叠/展开箭头。
在 settings.json 加：
"material-icon-theme.folders.associations": {
"node_modules": "folder"
}
这样它就变成普通灰色文件夹图标（folder），不加载动态图标逻辑。同理可处理 dist、build 等产出目录。
注意：folders.associations 只匹配文件夹名，不支持通配符或路径；想匹配 src/components 这种子路径？做不到 —— 插件不支持嵌套路径规则。
图标显示异常或字体发虚？检查 VSCode 字体渲染设置
图标本质是字体（material-icons.ttf），依赖系统字体渲染引擎。Windows 上常见模糊、锯齿、图标错位，往往不是主题问题，而是 VSCode 自身渲染配置冲突。
- 先试这个开关：
"workbench.fontAliasing": "default"（别设成antialiased或auto） - 如果用了自定义字体（比如
"editor.fontFamily": "'Fira Code'"），确保它不覆盖图标字体 ——Material Icon Theme会自动注入自己的字体声明，但某些安全策略或企业策略会拦截 - 最后检查：打开开发者工具（
Help → Toggle Developer Tools），看 Console 有没有Failed to load resource: net::ERR_FILE_NOT_FOUND报material-icons.woff2，说明插件资源没加载成功，重装插件或换网络环境再试
图标主题的底层机制比看起来复杂：它靠 CSS 注入 + 字体映射 + 文件扩展名/名称规则三层联动，任意一层断掉都会静默失败，不容易定位。
