VSCode文件图标缺失主因是图标主题未启用、language ID匹配失败或Explorer: Show Icons开关关闭；需依次检查workbench.iconTheme配置、files.associations映射及全局图标开关，并完全重启VSCode生效。
VSCode 文件图标缺失，90% 不是插件没装，而是图标主题没启用、语言识别错位、或系统级文件关联被破坏 —— 三者任一出问题，图标就彻底不显示。
workbench.iconTheme 没设或被清空
VSCode 默认不启用任何图标主题，即使你装了 vscode-icons，只要没手动选中，workbench.iconTheme 就是 null 或 ""，资源管理器里只显示空白图标。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Preferences: File Icon Theme - 从下拉列表中选一个非
None的主题，比如vscode-icons、Minimal或seti - 如果选完没变化，立刻打开
Preferences: Open Settings (JSON)，检查是否存在："workbench.iconTheme": null、"workbench.iconTheme": ""或"workbench.iconTheme": "none"
删掉或改为有效值，例如："workbench.iconTheme": "vscode-icons" - 必须完全退出 VS Code 再启动，缓存不刷新，图标不会回来
files.associations 配置错误导致语言 ID 不匹配
图标主题靠语言 ID 匹配图标，不是靠后缀名。比如 .env 被识别为 plaintext，而主题只给 shellscript 提供图标，它就只能显示默认文档图标。
- 打开一个图标异常的文件，看右下角状态栏显示的语言模式（如
Plain Text） - 点击该语言标识，手动切换为正确语言（如
Shell Script或JSON）；若切换后图标立刻出现，说明是files.associations问题 - 在
settings.json中添加或修正关联，注意语法严格："*.env": "shellscript"（键带引号、值小写、无空格）"docker-compose.yml": "yaml""tsconfig.json": "jsonc" - 避免写成
js、jsx这类非法语言 ID；dockerfile是语言 ID，不是Dockerfile
Explorer: Show Icons 开关被关闭
这是最隐蔽的“总闸”：即使主题正确、扩展激活，只要这个开关关了，所有文件图标一律不渲染。它独立于主题设置，且默认开启，但极易被误关。
- 按
Ctrl+,打开设置，搜索show icons - 确认
Explorer: Show Icons处于勾选状态 - 同时检查
settings.json是否存在错误配置："workbench.iconTheme": null或"workbench.iconTheme": "" - 已打开的文件需重新加载（
Ctrl+R）或关闭再打开，才能应用新关联
Windows 系统层图标缓存/文件关联损坏
VSCode 资源管理器里的图标和 Windows 资源管理器里的图标是两套机制。如果你发现 .py/.cpp/.java 在桌面或资源管理器里也显示白纸图标，问题大概率在系统层。
- 先怀疑系统图标缓存：同一个后缀的文件，有的显示正常、有的白纸 → 极可能是缓存不一致
- 按
Win+R输入ie4uinit.exe -ClearIconCache清除图标缓存（Windows 10/11 有效） - 若右键“打开方式”里 VSCode 选项消失或重复，需检查注册表：
HKEY_CLASSES_ROOT.py下的OpenWithProgids是否包含VSCode.pyHKEY_CLASSES_ROOTVSCode.pyDefaultIcon的默认值是否指向正确的图标路径（如"E:\VSCode\resources\app\resources\win32\python.ico"） - 修改注册表前务必备份对应项，操作后需重启
explorer.exe（任务管理器 → 重启 Windows 资源管理器）
真正卡住的往往是 workbench.iconTheme 配置与扩展重载的组合失败，以及 files.associations 值写错语言 ID —— 这两个点一旦出错，VSCode 不报错、不提示，图标就静默消失，很难定位。
