VSCode文件图标不显示主因是图标主题未启用：需手动执行Preferences: File Icon Theme选择非None主题，同时确保Explorer: Show Icons开启、workbench.iconTheme未被颜色主题清空为null/""，且文件语言ID识别正确。
VSCode 文件图标不显示，90% 是因为图标主题没“上场”，不是插件没装、也不是 VSCode 坏了。 你改了 settings.json、重装了扩展、甚至重启十次，图标还是白纸——大概率卡在「启用」这一步，或者被某层配置悄悄覆盖了。
Preferences: File Icon Theme 必须手动点一次
VSCode 默认不激活任何图标主题，哪怕你已安装 vscode-icons 或 material-icon-theme。它不会自动把 workbench.iconTheme 设成对应值，也不会提示你“该选一个了”。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Preferences: File Icon Theme - 从下拉列表中选一个非
None的选项，比如vscode-icons、Minimal或seti - 选完立刻生效，不用重启；如果没变化，说明问题不在这一环
Explorer: Show Icons 开关被关了
这是最隐蔽的“总闸”：即使主题正确、扩展已启用，只要这个开关关了，所有文件图标一律不渲染。它独立于主题设置，且默认开启，但极易被误关。
- 按
Ctrl+,打开设置，搜索show icons - 确认
Explorer: Show Icons处于勾选状态 - 检查
settings.json（用Preferences: Open Settings (JSON)打开），删掉或修正这两类错误配置："workbench.iconTheme": null或"workbench.iconTheme": ""
workbench.iconTheme 被颜色主题静默清空
某些热门颜色主题（如 OneDark-Pro、SynthWave '84）会在激活时把 workbench.iconTheme 设为 null 或空字符串，且不提示、不报错。
- 运行
Preferences: Open Settings (JSON)，检查是否存在："workbench.iconTheme": null、"workbench.iconTheme": ""或"workbench.iconTheme": "none" - 删掉或改成有效值，例如：
"workbench.iconTheme": "vscode-icons" - 必须完全退出 VS Code 再启动——缓存不刷新，图标不会回来
- 加一行注释锁定：
// ⚠️ 此值禁止被任何 colorTheme 覆盖，勿删
文件没被识别为对应语言，图标主题无从匹配
图标主题靠语言 ID 匹配图标，不是靠后缀名。比如 .env 文件若被识别为 plaintext，而当前主题只给 shellscript 提供图标，它就只能显示默认文档图标。
- 打开一个图标异常的文件，看右下角状态栏显示的语言模式（如
Plain Text） - 点击该语言标识，手动切换为正确语言（如
Shell Script或Markdown） - 若切换后图标立刻出现，说明是
files.associations配置问题 - 在
settings.json中添加或修正关联："*.env": "shellscript"（注意：键带引号、值小写、无空格）
真正卡住的往往是「扩展装了但没重载」+「总开关被关」+「颜色主题偷偷清空配置」三者叠加。VSCode 不会告诉你哪一层失效了，它只是沉默地显示白纸图标。
