图标不显示是因为未手动启用：必须执行preferences: file icon theme选择主题，确保workbench.icontheme值与扩展id完全一致（如"material-icon-theme"），并检查工作区设置是否覆盖、是否为单文件/remote-ssh模式。

装了图标扩展但资源管理器还是默认小方块？不是插件坏了，而是根本没启用——VSCode 从不自动激活图标主题。

Preferences: File Icon Theme 命令必须手动执行

VSCode 安装完 material-icon-theme 或 vscode-icons 后，只把图标资源下载到本地，workbench.iconTheme 字段仍为空或保持默认值 "vs-seti"。必须显式触发启用动作：

• 按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板
• 输入 Preferences: File Icon Theme 并回车
• 从列表中选中目标主题（如 Material Icon Theme），**不要选 None**
• 无需重启，资源管理器图标会秒级刷新

如果列表里压根没出现你装的主题，说明扩展未启用：去扩展页搜全名，确认状态是 Enable 而非灰色或 Disabled。

workbench.iconTheme 配置值必须与扩展 ID 完全一致

这个字段的值不是随便起的名字，而是扩展在 VSCode Marketplace 上注册的唯一标识符（Identifier）。写错一个字符就失效：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• ✅ 正确："workbench.iconTheme": "material-icon-theme"、"workbench.iconTheme": "vscode-icons"
• ❌ 错误："workbench.iconTheme": "Material Icon Theme"（含空格/大小写）、"workbench.iconTheme": "vscode_icons"（下划线）、"workbench.iconTheme": null 或 ""（强制禁用）
• 工作区级配置（.vscode/settings.json）优先级高于用户设置，若它写了 "workbench.iconTheme": null，该文件夹下图标必然退回到默认文档图标

单文件模式（Open File）和 Remote-SSH 下图标不加载

图标主题依赖文件系统上下文，两种常见场景会直接失效：

• 你用的是 File > Open File 打开单个 index.ts，而非 File > Open Folder —— 单文件模式下资源管理器不显示，图标主题自然无从加载
• 你通过 Remote-SSH 连接服务器，但只在本地装了图标扩展 —— 图标包必须在远程 VS Code Server 环境中单独安装，本地装了无效
• 右下角状态栏显示 Workspace Settings？说明当前处于多根工作区或有 .vscode/settings.json，得检查里面是否覆盖了 workbench.iconTheme

自定义文件/文件夹图标要配对扩展专属字段

想让 .env.local 显示锁图标、Dockerfile 显示鲸鱼图标，不能靠通用配置，必须写进对应扩展支持的字段：

• material-icon-theme 用 material-icon-theme.files.associations，例如：{"*.env.local": "tune", "Dockerfile": "docker"}
• vscode-icons 用 vsicons.associations，例如：{"vite.config.ts": "typescript"}
• 键名只能是完整文件名或通配符（如 "*.env"），不能带路径；值必须是该主题 GitHub README 中列出的图标 ID（如 tune，不是 tune-icon 或 lock）

这些映射只对对应扩展生效，换主题就得重配；而且图标名大小写敏感，拼错就回退到默认图标。