VSCode图标不显示主因是图标主题未启用:需手动执行Preferences: File Icon Theme选择非None主题,检查workbench.iconTheme是否被颜色主题静默清空为null或"",确认Explorer: Show Icons开关开启,并校验文件语言识别是否正确。

图标主题没启用,装了插件也不显示
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、Dracula Official)会在激活时静默把 workbench.iconTheme 设为 null 或 "",且不提示、不报错。这是最隐蔽也最常被忽略的根源。
运行 Preferences: Open Settings (JSON),检查是否存在以下任意配置:
"workbench.iconTheme": null"workbench.iconTheme": """workbench.iconTheme": "none"
删掉或修正为有效值,例如:"workbench.iconTheme": "vscode-icons";加一行注释锁定:// ⚠️ 此值禁止被任何 colorTheme 覆盖,勿删;必须完全退出 VS Code 再启动,缓存不刷新图标不会回来。
Explorer: Show Icons 开关被关了
这是最隐蔽的“总闸”:即使主题正确、扩展激活,只要这个全局开关关闭,所有文件图标一律不渲染。它独立于主题设置,且默认开启,但极易被误关。
按 Ctrl+, 打开设置,搜索 show icons;确认 Explorer: Show Icons 处于勾选状态;检查 settings.json 中是否误写了 "workbench.iconTheme": null 或 "workbench.iconTheme": "";若存在,一并删除或修正。
文件没被识别为对应语言,图标主题匹配失败
图标主题靠语言 ID 匹配图标,不是靠后缀名。比如 .env 文件若被识别为 plaintext,而当前主题只给 shellscript 提供图标,它就只能显示默认文档图标。
打开一个图标异常的文件,看右下角状态栏显示的语言模式(如 Plain Text);点击该语言标识,手动切换为正确语言(如 Shell Script 或 Markdown);若切换后图标立刻出现,说明是 files.associations 配置问题;在 settings.json 中添加或修正关联:"*.env": "shellscript"(注意:键带引号、值小写、无空格),避免写成 js 或 jsx 这类非法语言 ID。
真正卡住的往往是第二步和第三步的组合:颜色主题覆盖了图标配置 + 总开关被关;而且一旦 workbench.iconTheme 值拼错(比如写成 "vscode-icon"),VSCode 会静默回退到 None,不报错也不提醒——这点最容易被忽略。


















