文件图标空白主因是语言识别错误、图标主题未启用或workbench.icontheme被颜色主题静默清空；需手动切换右下角语言模式、启用非none图标主题、修正配置并完全重启vscode。
VSCode 文件图标识别错误，90% 不是插件没装，而是语言识别断链、图标主题未启用或配置被静默覆盖——三者任一缺失，图标就彻底不渲染。
为什么文件右下角显示 Plain Text，但图标还是空白？
图标主题靠 language ID 匹配图标，不是靠后缀名。比如 .env 文件若被识别为 plaintext，而你用的 vscode-icons 主题只给 shellscript 提供专属图标，它就只能 fallback 到默认文档图标。
- 打开该文件，看右下角状态栏显示的语言模式（如
Plain Text） - 点击它，手动切换为正确语言（如
Shell Script或JSON） - 若切换后图标立刻出现，说明问题出在自动识别逻辑上，不是主题或扩展失效
- 不要选
js或jsx这类非法language ID；合法值查 VSCode 官方语言列表，例如javascriptreact合法，jsx无效
files.associations 配置写对了却没生效？
files.associations 是映射后缀到语言 ID 的“开关”，但它不直接控制图标——图标主题依赖这个映射结果去匹配图标。配置错位、语法错误或写在错误位置，都会导致静默失败。
- 必须写在
settings.json的顶层对象内，不能嵌套在其他字段下 - 键必须带引号：
"*.env"，不能写成*.env - 值必须小写、无空格、全英文：
"shellscript"，不是ShellScript或shell script - 常见有效组合：
"Dockerfile": "dockerfile"、"tsconfig.json": "jsonc"、"*.log": "log" - 修改后已打开的文件需按
Ctrl+R重载，或关闭再打开才生效
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 再启动，缓存不刷新图标不会回来
图标主题装了但没“上场”？
VSCode 默认不激活任何图标主题，哪怕你已安装 vscode-icons 或 material-icon-theme，只要没手动选中，资源管理器里就只显示空白或通用文档图标。
- 按
Ctrl+Shift+P输入并执行Preferences: File Icon Theme - 从下拉列表中选一个非
None的主题，例如vscode-icons、Minimal或seti - 选完立刻生效，无需重启；若仍无变化，说明问题不在这一环
- 确认
Explorer: Show Icons开关已开启（搜索设置即可验证） - 扩展必须安装并重载：装完
vscode-icons后，点右下角“重新加载”按钮，否则扩展不会初始化
真正卡住的往往是语言识别 + 配置覆盖 + 扩展未重载这三者的组合。最容易被忽略的是：改完 files.associations 后忘记重载当前文件，或者以为装了插件就自动生效，其实必须点“重新加载”。
