VSCode文件图标不显示主因是图标主题未启用或配置错误：需手动安装vscode-icons等插件并设置"workbench.iconTheme": "vscode-icons"，检查工作区/远程设置是否覆盖，重启VSCode生效。

VSCode 文件图标不显示的常见原因

文件图标不显示，大概率不是插件没装，而是图标主题没启用、或被其他设置覆盖。VSCode 默认不带图标主题，必须手动安装并启用，且 workbench.iconTheme 配置项必须明确指定有效值。

确认并启用图标主题（如 vscode-icons）

装了 vscode-icons 插件后，它不会自动激活——你得手动选中它。打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入 Preferences: File Icon Theme，回车，再从列表里选 vscode-icons（注意不是 None 或 Minimal）。

也可以直接编辑 settings.json：

{
  "workbench.iconTheme": "vscode-icons"
}

确保该值是字符串，且与已安装图标的 ID 完全一致（可在插件详情页右下角看到 ID，比如 vscode-icons-team.vscode-icons 的主题 ID 就是 vscode-icons）。

检查是否被工作区设置或扩展覆盖

图标主题可能被以下几处覆盖，优先级从高到低：

• 当前工作区的 .vscode/settings.json（会覆盖用户设置）
• 远程开发（SSH/WSL/Container）中未同步安装图标插件
• 某些主题扩展（如 One Dark Pro）自带轻量图标，但默认禁用完整图标支持
• workbench.colorTheme 和 workbench.iconTheme 冲突（极少见，但存在）

排查方法：关闭所有文件夹，打开空窗口 → 执行 Preferences: Open Settings (JSON) → 看用户级 settings.json 是否含 "workbench.iconTheme"；再打开项目，检查项目级 .vscode/settings.json 是否有同名配置且值为 null 或 ""。

重启 VSCode 并验证插件状态

改完设置后必须完全重启 VSCode（不是重载窗口），否则图标缓存不刷新。另外确认插件处于启用状态：

• 在扩展视图搜索 vscode-icons
• 看右下角是否有「启用」按钮（如果显示「禁用」，说明它被手动关过）
• 点击插件右上角齿轮 → 确保「启用」打钩，且没有勾选「在远程中禁用」

如果使用 Remote-SSH，需在远程端也安装该插件（本地装了不影响远程窗口的图标显示）。

图标主题对性能影响极小，但一旦配置错值（比如拼错成 "vscode-icon"），VSCode 会静默回退到 None，不报错也不提醒——这是最常被忽略的一点。