VSCode文件图标显示错乱主因是图标主题未启用、workbench.iconTheme被覆盖、语言识别失败或缺少Nerd Fonts字体；需依次检查并启用图标主题、修正JSON配置、手动设置语言模式、安装并配置Nerd Fonts。
VSCode文件图标显示错乱，90%不是插件坏了，而是图标主题没启用、workbench.iconTheme被静默覆盖、语言识别失败，或字体不支持符号渲染——四者任一出问题，图标就断链。
图标主题根本没启用，装了等于白装
VSCode默认不激活任何图标主题，哪怕你已安装vscode-icons或material-icon-theme，只要没手动选中，资源管理器里就只显示空白或通用文档图标。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Preferences: File Icon Theme - 从下拉列表中选一个非
None的主题，例如vscode-icons、material-icon-theme（注意大小写和连字符） - 选完立刻生效，无需重启；若仍无变化，说明问题不在这一环
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 再启动，缓存不刷新图标不会回来
文件没被识别为对应语言，图标主题无从匹配
图标主题靠语言 ID 匹配图标，不是靠后缀名。比如 .env 文件若被识别为 plaintext，而当前主题只给 shellscript 提供图标，它就只能显示默认文档图标。
- 打开一个图标异常的文件，看右下角状态栏显示的语言模式（如
Plain Text） - 点击该语言标识，手动切换为正确语言（如
Shell Script或Markdown） - 若切换后图标立刻出现，说明是
files.associations配置问题 - 在
settings.json中添加或修正关联："*.env": "shellscript"（注意：键带引号、值小写、无空格） - 避免写成
js或jsx这类非法语言 ID
图标显示为方块 □？缺 Nerd Fonts 字体
很多图标主题（尤其是 vscode-icons）依赖 Nerd Fonts 渲染符号图标。系统缺字体，VSCode 就 fallback 到空白方块或问号。
- Windows 用户需下载并安装 Nerd Font（如
FiraCode Nerd Font），再在 VSCode 设置中指定："editor.fontFamily": "'FiraCode Nerd Font', Consolas, 'Courier New', monospace" - macOS 用户可用 Homebrew 安装：
brew tap homebrew/cask-fonts && brew install --cask font-fira-code-nerd-font - Linux 用户需手动安装字体并刷新缓存：
sudo fc-cache -fv - 别同时启用多个图标主题扩展——VSCode 不报错，但后者会静默覆盖前者
最容易被忽略的是：图标主题和颜色主题之间没有自动联动逻辑。即使你选了 Dracula Official 颜色主题，也得单独执行一次 Preferences: File Icon Theme 才能让文件夹和 .ts/.json 文件显示对应图标。
