vscode文件图标不显示的三大主因是workbench.icontheme未生效、explorer: show icons总开关关闭、文件未被识别为对应语言id；三者缺一不可，任一出错图标均不显示。
VSCode 文件图标不显示，90% 不是插件没装，而是 workbench.iconTheme 没生效、Explorer: Show Icons 总开关被关了，或者文件压根没被识别成对应语言 ID——三者缺一不可，改错一个就全白搭。
为什么 Preferences: File Icon Theme 选了还是没图标
这个命令只是设置 workbench.iconTheme 的值，但前提是：扩展已安装、已启用、且值拼写完全正确。常见翻车点：
-
workbench.iconTheme值写成了"vscode-icon"（少个s）或"vscode-icons-team.vscode-icons"（ID 错了，实际主题 ID 是"vscode-icons"） - 扩展装了但没点「重新加载」，或右下角提示「已安装」后直接关了窗口，扩展根本没初始化
- 同时启用了
material-icon-theme和vscode-icons，VS Code 只认最后一个注册的主题，但不报错也不提示 - 在命令面板里选完主题后，没注意状态栏右下角是否真的显示了
vscode-icons字样——没显示 = 没真正激活
Explorer: Show Icons 被关了，图标全灭
这是最隐蔽的“总闸”。哪怕主题和扩展都对，只要这个开关关了，所有文件图标一律不渲染。它独立于主题配置，且默认开启，但极易被误关：
- 按
Ctrl+,打开设置，搜show icons，确认Explorer: Show Icons是勾选状态 - 用
Preferences: Open Settings (JSON)检查，删掉类似"workbench.iconTheme": null或"workbench.iconTheme": ""这种非法值 - 如果之前手动改过
settings.json，加了注释行但漏了逗号、引号用了中文、多了一层括号，整个 JSON 解析失败，VS Code 会静默忽略全部配置
文件图标只在部分文件上失效，比如 .env 或 Dockerfile
图标主题靠语言 ID 匹配图标，不是靠后缀名。如果 .env 被识别为 plaintext，而主题只给 shellscript 提供图标，那它就只能显示空白文档图标：
- 打开那个文件，看右下角状态栏显示的语言模式（如
Plain Text），点它手动切换成Shell Script，图标立刻出现就说明是识别问题 - 在
settings.json中加"files.associations"映射，语法必须严格："*.env": "shellscript"（键带引号、值小写、无空格、不能写js或jsx这类非法 ID） - 某些语言 ID 需要额外扩展支持，比如
dockerfile不是内置语言，得装 Docker 扩展才能激活；jsonc支持注释，比json更适合配置文件
工作区设置或远程开发导致图标时有时无
VS Code 设置优先级是：工作区 > 用户 > 默认。只要项目根目录下有 .vscode/settings.json，它的 workbench.iconTheme 就会盖掉你用户级的设置：
- 打开空窗口（不打开任何文件夹），执行
Preferences: Open Settings (JSON)，看用户级配置是否正常 - 再打开项目，检查
.vscode/settings.json是否存在且含"workbench.iconTheme": null或空字符串 - 用 Remote-SSH/WSL 时，图标扩展必须装在远程端，本地装了不影响远程窗口的图标渲染
- 某些颜色主题（如
OneDark-Pro）会在激活时静默把workbench.iconTheme设为null，加一行注释锁定：// ⚠️ 此值禁止被任何 colorTheme 覆盖,勿删
真正卡住的往往是扩展没重载 + 总开关被关 + 工作区配置覆盖这三者的组合。VS Code 对错误极其沉默：拼错 ID、值为空、JSON 格式错，它都不报错，只悄悄 fallback 到 None——所以别猜，先去状态栏右下角看有没有显示主题名，没有就等于没生效。
