VSCode文件图标不显示主因是workbench.iconTheme未生效、被颜色主题静默覆盖为null/""、工作区设置覆盖用户配置，或文件语言ID识别错误；需依次检查并修正配置、启用扩展、锁定注释、完全重启及校准files.associations。
VSCode 文件图标不显示，90% 的情况不是插件没装，而是 workbench.iconTheme 没生效、被覆盖，或文件根本没被识别为对应语言——三者任一缺失，图标就彻底不渲染。
检查 workbench.iconTheme 是否被设为 null 或空字符串
某些颜色主题（如 OneDark-Pro、Dracula Official）激活时会静默把 workbench.iconTheme 改成 null 或 ""，且不提示、不报错。这种覆盖行为极隐蔽，但后果直接：图标全消失。
- 运行
Preferences: Open Settings (JSON)，搜索workbench.iconTheme - 删掉整行
"workbench.iconTheme": null或"workbench.iconTheme": ""，改写为有效值，例如："workbench.iconTheme": "vscode-icons" - 加一行注释锁定：
// ⚠️ 此值禁止被任何 colorTheme 覆盖,勿删 - 必须完全退出 VS Code 再启动——仅
Developer: Reload Window不刷新图标缓存
确认图标扩展已安装且启用，不是“装了但没跑”
插件只提供资源，不自动接管渲染逻辑。workbench.iconTheme 指向一个不存在或未启用的扩展 ID，VS Code 会静默回退到 None，不报错也不提醒。
- 打开扩展视图（
Ctrl+Shift+X），搜vscode-icons，认准作者是robertohuertasm的官方版本 - 看右下角是否显示「启用」按钮；如果显示「禁用」，说明它被手动关过，点一下启用
- 右键插件 → 「扩展设置」→ 确保没有勾选「在远程中禁用」（若用 Remote-SSH/WSL，需在远程端也安装）
- 安装后务必点右下角「重新加载」按钮，或关掉再开 VS Code —— 否则扩展不会初始化
排查工作区设置（.vscode/settings.json）是否覆盖用户设置
VS Code 设置优先级：工作区 > 用户 > 默认。只要当前项目根目录下存在 .vscode/settings.json，它的 workbench.iconTheme 就会顶掉你全局配好的值。这是“换个项目图标就出来”的根本原因。
- 关闭所有文件夹，打开空窗口 → 运行
Preferences: Open Settings (JSON)→ 查用户级配置是否含workbench.iconTheme - 再打开项目 → 检查
.vscode/settings.json是否存在同名项，且值为null、""或拼错的 ID（如"vscode-icon"） - 如果确认是工作区覆盖导致，可临时删掉该文件（先备份），或直接在其中修正为正确值
- 注意：Git 仓库里提交的
.vscode/settings.json常含这类干扰配置，自己没动过也可能中招
验证文件是否被识别为正确语言模式
图标主题靠语言 ID 匹配图标，不是靠后缀名。比如 .env 被识别为 plaintext，而当前主题只给 shellscript 提供图标，它就只能显示默认文档图标。
- 打开一个图标异常的文件，看右下角状态栏显示的语言模式（如 Plain Text）
- 点击该语言标识，手动切换为正确语言（如 Shell Script、JSON、YAML）→ 若图标立刻出现，说明是识别问题
- 在
settings.json中添加或修正files.associations：
{
"files.associations": {
"*.env": "shellscript",
"Dockerfile.*": "dockerfile",
"docker-compose.yml": "yaml",
"tsconfig.json": "jsonc"
}
}
js 和 jsx 是非法的，应为 javascript 和 javascriptreact）真正卡住人的地方往往不是「怎么配」，而是「谁在悄悄关掉它」——颜色主题静默覆盖、工作区配置继承、语言 ID 写错却不报错。这些错误都不会弹窗，只会让图标安静地消失。
