文件图标全变白纸是系统图标缓存损坏所致，需运行ie4uinit.exe -clear清缓存；vscode图标消失则因icontheme配置错误或未重载扩展，须检查设置、禁用冲突主题并彻底重启。

文件图标全变白纸？先清系统图标缓存

Windows 资源管理器里 .py/.cpp/.java 全是白纸，但双击能正常打开 VSCode——这基本不是 VSCode 的问题，而是系统图标缓存损坏或冲突。Explorer 不会实时读取每个文件的图标资源，而是依赖本地缓存数据库，一旦缓存索引错乱（比如装过多个 IDE、反复改过“打开方式”），就会批量显示为白纸。

直接清缓存最有效：

• 按 Win+R 输入 ie4uinit.exe -Clear 回车（无需管理员权限，立刻刷新）
• 若无效，再执行 ie4uinit.exe -Show 强制重建图标数据库
• 最后重启 explorer.exe：任务管理器 → 找到“Windows 资源管理器” → 重启

注意：ie4uinit.exe 是 Windows 自带工具，所有 Win10/Win11 都有，别去下载第三方“图标修复软件”。

VSCode 侧边栏图标消失？检查 iconTheme 是否被静默覆盖

VSCode 资源管理器里的图标和系统桌面图标完全无关，它靠的是 workbench.iconTheme 配置 + 对应扩展 + 语言识别三者联动。90% 的“图标消失”其实是因为主题没真正启用，或者被颜色主题悄悄覆盖。

必须手动验证这三点：

• 按 Ctrl+Shift+P 运行 Preferences: File Icon Theme，选一个非 None 的主题（如 vscode-icons）
• 打开 settings.json（Preferences: Open Settings (JSON)），删掉或修正这些非法值："workbench.iconTheme": null、"workbench.iconTheme": ""、"workbench.iconTheme": "none"
• 某些颜色主题（如 OneDark-Pro）会在激活时自动把 workbench.iconTheme 清空，加一行注释锁定：// ⚠️ 此值禁止被任何 colorTheme 覆盖,勿删

改完必须完全退出 VSCode 再启动，否则缓存不刷新，图标不会回来。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

图标只在部分文件上出现？查 language ID 是否匹配

VSCode 图标主题不看后缀名，只认语言 ID。比如 .env 文件默认被识别为 plaintext，但 vscode-icons 只给 shellscript 提供专属图标，结果就是显示空白文档图标。

快速验证和修复：

• 打开一个图标异常的文件，看右下角状态栏显示的语言模式（如 Plain Text）
• 点击该语言标识，手动切换为正确语言（如 Shell Script、Python、Java）
• 若切换后图标立刻出现，说明是 files.associations 配置缺失
• 在 settings.json 中添加："*.env": "shellscript"（注意：键必须带引号，值小写，无空格）

别写 js 或 jsx 这类非法 language ID，VSCode 会静默忽略整条配置。

扩展装了但图标还是不显示？重载是硬性要求

workbench.iconTheme 配置依赖对应扩展存在且已初始化。只在 settings.json 里写了 "vscode-icons" 却没装扩展，VSCode 会直接跳过该设置——不报错、不提示、图标照样空白。

操作必须闭环：

• 进扩展面板（Ctrl+Shift+X），搜 vscode-icons，认准作者是 robertohuertasm 的官方版
• 安装后右下角提示“已安装”，但必须点“重新加载”按钮（或彻底退出 VSCode）
• 如果之前同时启用了 material-icon-theme 和 vscode-icons，禁用其中一个再测试
• 确认 Explorer: Show Icons 开关已开启（设置里搜 show icons）

最容易被忽略的是“重载”这一步——很多人以为装完就生效，其实扩展 JS 模块根本没加载，图标主题压根没运行。