material icon theme 需手动启用且配置正确才生效；未启用、id拼写错误、工作区覆盖、远程环境未安装、文件/文件夹未关联图标等均会导致图标不显示。
Material Icon Theme 是当前最可靠、更新最勤、适配最广的 VSCode 文件图标美化方案。它不是装完就生效，必须手动启用；也不是所有文件类型默认就有图标，得靠配置补全。
为什么装了 Material Icon Theme 还是显示小方块？
核心原因只有一个：VSCode 没启用它。Material Icon Theme 安装后处于“静默就位”状态，不触发任何自动激活逻辑。
- 检查命令面板是否能搜到
Preferences: File Icon Theme—— 如果列表里没有Material Icon Theme，说明扩展未启用或安装失败，去 Extensions 页面确认状态为 Enable，作者是 PKief - 确认没误选
None或其他图标主题（比如vscode-icons），VSCode 只认一个激活项 - 打开的是文件夹（
File > Open Folder），不是单个文件（File > Open File）—— 单文件模式下图标主题通常不加载 - 如果是 Remote-SSH / WSL / Dev Containers，插件必须在远程环境中单独安装并启用，本地装了无效
workbench.iconTheme 配置写错就会失效
这个字段值不是显示名，而是扩展注册的唯一 ID，拼错一个字符都不行。
- 正确值：
"workbench.iconTheme": "material-icon-theme"（注意是短横线，不是空格或下划线） - 常见错误：
"material-icon-them"、"Material Icon Theme"、"material_icon_theme"、null、"" - 工作区级设置（
.vscode/settings.json）优先级高于用户设置，哪怕你全局配对了，只要当前项目里写了"workbench.iconTheme": null，图标就退回到默认样式 - 右下角状态栏点 Settings 图标，看是否显示 “Workspace Settings”，如果是，就得去项目根目录下的
.vscode/settings.json里也加这行
怎么让 .env、Dockerfile、vite.config.ts 显示图标？
这些文件默认不映射图标，Material Icon Theme 不会报错，只会默默 fallback 到通用文档图标。
- 必须在
settings.json中添加material-icon-theme.files.associations配置项 - 键名支持完整文件名（
"Dockerfile"）、带点扩展名（".env"）、通配符（"*.config.ts"） - 值必须是主题内置的图标 ID，比如
"docker"、"tune"、"typescript"—— 查法：打开插件 GitHub 仓库的icons/目录或 README 的iconDefinitions列表 - 示例：
"material-icon-theme.files.associations": {
".env": "tune",
"Dockerfile": "docker",
"vite.config.ts": "typescript",
"*.astro": "astro"
}
文件夹图标配不准、箭头不显示、颜色调不了？
这些功能只在 Material Icon Theme 中原生支持，vscode-icons 不提供等效能力。
- 显示展开箭头：
"material-icon-theme.showFolderArrows": true - 自定义文件夹图标：
material-icon-theme.folders.associations，键名是纯文件夹名（"src"、"lib"），值是图标 ID（"src"、"library"），大小写敏感 - 统一调整颜色饱和度或透明度：
"material-icon-theme.saturation": 1.5、"material-icon-theme.opacity": 0.85 - 给特定文件夹上色：
Material Icon Theme: Set Folder Color命令（右键文件夹 → Run Command）
workbench.iconTheme 彻底失效。先查状态栏右下角，再开命令面板，最后翻 settings.json，比重装插件快得多。
