图标不显示的根本原因是workbench.icontheme未正确配置：必须设为对应插件id（如"vscode-icons"），且不能为null、""或拼写错误；远程开发需在远程端单独安装启用；单文件模式下图标主题本就不生效。
图标不显示？先查 workbench.iconTheme 是否设对了
装了 vscode-icons 或 material-icon-theme 却只看到小方块，大概率是配置项没生效。VSCode 不会自动启用图标主题——插件安装只是把代码放本地，真正起作用的是 workbench.iconTheme 这个设置项。
常见错误包括：
-
"workbench.iconTheme": null或"workbench.iconTheme": ""：这会强制禁用所有图标，比没装插件还彻底 - 工作区级
.vscode/settings.json里写了"workbench.iconTheme": "none"，它优先级高于用户设置，直接覆盖 - 值拼错，比如写成
"vscode-icon"（少个s）或"material-icon-theme"（实际 ID 是material-icon-theme，但部分版本要求全小写且无连字符，得看插件详情页右下角的 ID）
验证方法：打开命令面板（Cmd+Shift+P / Ctrl+Shift+P），输入 Preferences: Open Settings (JSON)，检查该配置是否为字符串、是否与插件 ID 完全一致。
远程开发（SSH/WSL）时图标失效怎么办
本地装了图标插件，但 Remote-SSH 窗口里还是默认图标——这不是 Bug，是设计如此。VSCode 的远程模式中，图标渲染由远程端的 VS Code Server 执行，本地插件完全不参与。
必须在远程环境中单独安装：
- 连接到远程机器后，在扩展面板里搜索
vscode-icons或material-icon-theme - 确保勾选“在远程中启用”（右键插件 → “在远程中启用”，或点击插件右上角齿轮图标确认）
- 如果远程是离线环境，需提前打包插件
.vsix文件，用code --install-extension xxx.vsix命令手动安装
注意：Remote-WSL 和 Dev Containers 同理，不能复用本地插件状态。
material-icon-theme 的几个关键自定义项别漏配
这个插件默认只开基础图标，很多实用功能是关闭的。不配就等于白装：
-
material-icon-theme.showFolderArrows：控制文件夹前是否显示 ▶ 箭头，开启后结构更清晰 -
material-icon-theme.files.associations：手动映射特殊文件，例如"*.env": "config"让.env显示齿轮图标 -
material-icon-theme.opacity：调低至0.8左右可缓解深色主题下图标的刺眼感 -
material-icon-theme.hidesExplorerArrows：设为true可隐藏文件夹箭头，适合极简风格
这些配置写进 settings.json 即可，无需重启，改完保存就实时生效。
单文件打开模式下图标不加载是正常行为
如果你是通过 File > Open File 打开一个 index.ts，而不是 File > Open Folder 打开整个项目，资源管理器根本不会出现，图标主题自然无从谈起。
这是 VSCode 的限制，不是插件问题：
- 图标主题仅在「文件夹工作区」下激活；单文件模式下，侧边栏默认隐藏，
workbench.iconTheme设置被忽略 - 即使你强行打开资源管理器（
View > Explorer），也不会显示任何文件图标，因为没有根目录上下文来判断文件类型归属 - 解决办法只有一个：始终用
Open Folder启动项目
这点容易被忽略——尤其新手常以为“能编辑文件=有完整工作区”，其实差一个文件夹层级。
