VSCode文件图标显示异常的主因是图标主题未启用、workbench.iconTheme被静默清空或覆盖、语言识别错误、图标扩展未安装或未重载；需依次检查并修复这四点，缺一不可。
VSCode 文件图标显示异常，90% 是图标主题没启用、配置被覆盖、或语言识别断链——三者任一缺失，图标就彻底不渲染。
图标主题没启用，装了等于白装
VSCode 默认不激活任何图标主题，哪怕你已安装 vscode-icons 或 material-icon-theme，只要没手动选中，资源管理器里就只显示空白或通用文档图标。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Preferences: File Icon Theme - 从下拉列表中选一个非
None的主题，例如vscode-icons、Minimal或seti - 选完立刻生效，无需重启；若仍无变化，说明问题不在这一环
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 再启动，缓存不刷新图标不会回来
文件没被识别为对应语言，图标主题无从匹配
图标主题靠语言 ID 匹配图标，不是靠后缀名。比如 .env 文件若被识别为 plaintext，而当前主题只给 shellscript 提供图标，它就只能显示默认文档图标。
- 打开一个图标异常的文件，看右下角状态栏显示的语言模式（如
Plain Text） - 点击该语言标识，手动切换为正确语言（如
Shell Script或JSON） - 若切换后图标立刻出现，说明是
files.associations配置问题 - 在
settings.json中添加或修正关联："*.env": "shellscript"（注意：键带引号、值小写、无空格）
扩展没装或没重载，配置静默失败
workbench.iconTheme 配置依赖对应扩展存在并激活。如果只写了 "workbench.iconTheme": "vscode-icons" 却没装扩展，VSCode 会忽略该设置，图标照样不显示——且不报错、不提示。
- 点击左侧扩展图标（
Ctrl+Shift+X），搜索vscode-icons，认准作者是robertohuertasm的官方版本 - 安装后右下角提示“已安装”，但必须点“重新加载”按钮（或关闭再打开 VSCode），否则扩展不会初始化
- 若之前装过冲突图标扩展（如同时启用了
material-icon-theme和vscode-icons），禁用其中一个再测试
真正卡住的往往是第二步和第三步的组合：扩展装了但没重载 + workbench.iconTheme 被颜色主题悄悄覆盖。这两个地方一旦出错，VSCode 不会报错，也不会提醒，只会安静地显示空白图标——这是最常被忽略的一点。
