VSCode装完图标扩展没显示，是因为默认不自动启用，必须手动执行Preferences: File Icon Theme选择主题并重载窗口；常见原因包括扩展未启用、workbench.iconTheme值拼写错误、被工作区或远程设置覆盖，以及自定义文件后缀未映射。
装完扩展没图标？不是插件坏了，是 VSCode 坚决不自动启用——你必须手动选一次主题，workbench.iconTheme 才会写进配置里。
为什么装了 Material Icon Theme 还是蓝方块？
VS Code 把图标主题和颜色主题完全分开管理。安装扩展只是把图标资源下载到本地，不改任何配置项，也不激活。它默认用内置的 vs-seti（就是那个空心方块+小箭头），哪怕你装了 10 个图标包也毫无反应。
- 常见错误现象：
settings.json里写了"workbench.iconTheme": "material-icon-theme"却没生效 → 很可能扩展根本没启用，或 ID 拼错（比如写成MaterialIconTheme、material-icon、material-icon-theme（末尾空格）） - 检查路径：该字段只在用户设置或工作区
.vscode/settings.json中有效，不能靠插件自己注册 - 多根工作区下，某个子文件夹的
.vscode/settings.json若含"workbench.iconTheme": null，该文件夹图标会强制退回到默认样式，且界面不提示
必须手动执行 Preferences: File Icon Theme
这是最稳妥的启用方式，避免手写 JSON 出错，也绕过“扩展已安装但未启用”的陷阱。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Preferences: File Icon Theme - 从列表中选
Material Icon Theme（注意不是None，也不是Seti等内置选项） - 确认右下角状态栏出现
Material Icon Theme字样——没出现说明没生效 - 如果命令面板里根本没列出这个主题，去扩展面板检查：
material-icon-theme是否已启用（不是“已安装”）、ID 是否拼错（正确 ID 是material-icon-theme）
让 .env.local、vite.config.ts 这类文件也显示图标
Material Icon Theme 默认只覆盖主流后缀（如 .js、.json），自定义配置文件需手动映射，且字段名和图标名都严格绑定扩展本身。
- 在
settings.json中添加"material-icon-theme.files.associations"字段 - 键名是文件名或通配符（如
"*.env"），不能带路径；值必须是该主题实际支持的图标标识符（查其 GitHub README 的 icon list，写成tune而非tune-icon） - 示例：
"*.env.local": "tune"、"vite.config.ts": "typescript"、".prettierrc.*": "settings" - 改完保存后通常立即生效；若没反应，优先执行
Developer: Reload Window，比重启 VSCode 快得多
容易被忽略的覆盖点和静默失效场景
真正麻烦的点往往不在“怎么装”，而在“谁在覆盖你的设置”——多层 settings（用户 / 工作区 / 远程）叠加时，图标主题很容易被静默重置。
- Linux 下使用 Snap 安装的 VS Code：因沙盒限制，部分图标字体路径不可读，建议改用
.deb或官方tarball版本 - Remote-SSH 场景：图标主题需在远程 VS Code Server 环境中重新安装，本地装了没用
- 扩展禁用状态不存于
settings.json，而是存在用户级元数据中；重装系统或迁移配置时，光备份 JSON 文件会导致界面回归默认——得一并导出已启用的扩展列表 - 图标名拼错字段（比如写成
folders.associations而非material-icon-theme.folders.associations）不会报错，但 VS Code 直接忽略整段配置
