VSCode 默认不显示文件专属图标，必须手动启用图标主题（如 vscode-icons 或 Material Icon Theme），否则即使扩展已安装启用，资源管理器仍显示通用纸张图标；根本原因是 workbench.iconTheme 默认为空，需显式配置且值须与扩展 ID 严格一致。
VSCode 默认不显示文件专属图标，装了扩展不启用等于白装——必须手动激活图标主题，否则资源管理器里全是通用文档图标。
为什么装了 vscode-icons 或 Material Icon Theme 却没图标？
常见错误现象是：扩展已安装、甚至显示“已启用”，但资源管理器里的 package.json、tsconfig.json、.gitignore 还是空白纸张图标。根本原因不是扩展失效，而是 VSCode 的图标主题（workbench.iconTheme）和颜色主题（workbench.colorTheme）完全独立，且默认值为空。
你必须显式选择一个图标主题，系统才开始加载对应图标映射表。这步不能跳过，也不能靠“重装扩展”或“重启 VSCode”绕过。
- 检查是否误点了扩展页的“Enable”按钮——那只是启用扩展本身，不等于启用图标主题
- 确认没在
settings.json中硬编码了已卸载图标的名称，例如"workbench.iconTheme": "some-old-icon-theme"，会导致所有图标变为空白方块 - Mac 用户注意：Cmd + Shift + P 打开命令面板后，输入
Preferences: File Icon Theme要完整拼写，漏掉冒号或空格会搜不到
vscode-icons 和 Material Icon Theme 怎么选？
二者都支持主流文件类型，但行为细节不同，影响日常使用体验：
-
vscode-icons安装后默认自动注册为可用主题，但不会自动启用；启用后默认隐藏文件扩展名（如把README.md显示为纯README图标），若需显示扩展名，得关掉"vsicons.hideFiles"和"vsicons.hideFolders" -
Material Icon Theme启用后默认显示扩展名，且支持更细粒度的自定义：可通过"material-icon-theme.folders.associations"把src文件夹强制映射为src图标，或把Dockerfile绑定到容器图标 - 性能上无差异，但
Material Icon Theme启动时可能弹一次更新提示，可加"material-icon-theme.showUpdateMessage": false关闭
如何用 settings.json 强制指定图标主题？
适合团队统一配置、CI 环境初始化或版本化管理场景。直接编辑用户设置文件比图形界面更可靠，尤其当 GUI 操作被拦截或卡住时。
打开 settings.json（Cmd + , → 右上角花括号图标），添加这一行：
"workbench.iconTheme": "vscode-icons"
或：
"workbench.iconTheme": "material-icon-theme"
注意：workbench.iconTheme 值必须与扩展 ID 严格一致（大小写敏感），可在扩展详情页 URL 末尾看到，例如 PKief.material-icon-theme 的 ID 就是 material-icon-theme。
- 改完保存，VSCode 自动生效，无需重载窗口
- 如果改完仍无图标，说明该扩展未安装，或 ID 拼错（比如写成
material-icon-them少了个 e） - 这个字段优先级高于命令面板选择，一旦写死，GUI 切换就无效
右键手动绑定图标对临时文件有用吗？
有用，但仅限当前工作区。当你遇到 Dockerfile.prod、.env.local 这类非标准命名的文件，图标主题默认不识别，这时可以：
- 在资源管理器中右键该文件 →
Change Icon for '.prod'（或对应后缀） - 从弹出列表中选一个接近语义的图标，比如容器、齿轮、锁形等
- VSCode 会自动在当前工作区的
.vscode/settings.json中写入映射规则，例如："material-icon-theme.files.associations": { ".prod": "docker" }
这个操作不污染全局设置，适合项目特定约定。但别指望它批量生效——每个后缀都要单独点一次右键。
真正容易被忽略的是：图标主题和颜色主题是两套完全独立的配置系统，它们之间没有联动逻辑。你换了暗色主题，图标不会自动变亮；你启用了新图标包，语法高亮也不会跟着改。一切都要分别确认、分别调试。
