文件图标全变白纸,首要原因是图标主题未启用;需通过命令面板执行preferences: file icon theme并选择有效主题,否则即使安装插件也不会显示图标。

文件图标全变白纸?先确认是不是主题根本没启用
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";加一行注释锁定:// ⚠️ 此值禁止被任何 colorTheme 覆盖,勿删;必须完全退出 VS Code 再启动,缓存不刷新图标不会回来。
扩展没装或没重载,配置静默失败
workbench.iconTheme 配置依赖对应扩展存在并激活。如果只写了 "workbench.iconTheme": "vscode-icons" 却没装扩展,VSCode 会忽略该设置,图标照样不显示——且不报错、不提示。
点击左侧扩展图标(Ctrl+Shift+X),搜索 vscode-icons,认准作者是 robertohuertasm 的官方版本;安装后右下角提示“已安装”,但必须点“重新加载”按钮(或关闭再打开 VSCode),否则扩展不会初始化;若之前装过冲突图标扩展(如同时启用了 material-icon-theme 和 vscode-icons),禁用其中一个再测试。
Explorer: Show Icons 开关被关了
这是最隐蔽的“总闸”:即使主题正确、扩展激活,只要这个全局开关关闭,所有文件图标一律不渲染。它独立于主题设置,且默认开启,但极易被误关。
按 Ctrl+, 打开设置,搜索 show icons;确认 Explorer: Show Icons 处于勾选状态;检查 settings.json(用 Preferences: Open Settings (JSON) 打开),删掉或修正这两类错误配置:"workbench.explorer.fileIcons": false 或 "explorer.enableFileIconThemes": false。
真正卡住的往往是第二步和第三步的组合:颜色主题覆盖了图标配置 + 扩展没重载。这两个环节一漏,你就永远在白纸图标里打转。











