安装 Material Icon Theme 后图标未生效，需手动启用并重载窗口；文件后缀未显示对应图标时应检查是否被插件支持，多段后缀需用 glob 模式映射；自定义图标优先级为 files.associations > folders.associations > 默认规则；调色缩放应使用插件原生设置项而非 CSS 注入。
安装 Material Icon Theme 后图标没生效？检查是否启用并重载窗口
装完插件图标不显示，大概率是没手动启用——VSCode 不会自动激活图标主题。打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入 Preferences: File Icon Theme，回车后选择 Material Icon Theme。选完别忘了点右下角弹出的 “Reload Window”，否则配置只是“存在”，不会“工作”。
常见错误现象：settings.json 里写了 "workbench.iconTheme": "material-icon-theme" 却没效果，就是漏了重载。Windows/macOS/Linux 全部适用，不重载=白配。
文件后缀没对应图标？确认文件名/扩展名是否被插件支持
Material Icon Theme 默认只对常见后缀（如 .js、.py、.md）开箱即用，但像 .env.local、.prettierrc.cjs、.gitignore 这类带点的多段后缀，它默认只认最后一段（cjs、gitignore），前面的修饰部分被忽略。
- 使用场景：你看到
.env.production和.env.development都显示普通文件图标，不是齿轮或锁形图标 - 解决办法：在
settings.json中手动映射，例如："material-icon-theme.files.associations": { ".env.*": "gear", ".prettierrc.*": "settings" } - 注意参数差异：
.env.*是 glob 模式，不是正则；星号只能匹配一级（.env.dev.local不会被.env.*覆盖）
自定义图标覆盖默认行为？优先级和路径写法很关键
你加了自定义关联，但某些文件还是用默认图标，多半是优先级冲突。Material Icon Theme 的匹配顺序是：files.associations > folders.associations > 默认内置规则。
- 容易踩的坑：
"*.test.js"这种写法无效——它只支持以.开头的扩展名，不支持通配前缀；正确写法是".test.js"（表示文件名以.test.js结尾） - 性能影响：大量模糊匹配（如
".*"）不会明显拖慢启动，但会让图标逻辑变难维护，建议只覆盖真实需要区分的文件 - 兼容性提示：VSCode 1.80+ 支持
.jsonc文件图标，旧版需升级或手动加".jsonc": "json"
图标颜色/大小看起来奇怪？别动 CSS，改设置项更稳妥
有人想用用户 CSS 注入强行调色或缩放图标，结果导致更新后失效、暗色模式错位、甚至干扰其他插件。Material Icon Theme 提供了原生控制项，比 hack 安全得多。
-
"material-icon-theme.folders.theme": "specific"—— 让文件夹图标按名称（如node_modules、docs）显示专属图标 -
"material-icon-theme saturation": 0.7—— 控制图标饱和度（0.0–1.0），比改 CSS 更轻量、更稳定 - 为什么这样做：CSS 注入绕过插件生命周期，重启 VSCode 或插件更新后常丢失；而这些配置项是插件主动读取的，每次加载都生效
真正复杂的地方不在怎么配，而在什么时候该停手——比如为 .log、.tmp 单独设图标，收益极小，反而增加配置维护成本。图标是辅助，不是目标。
