图标包必须单独安装启用，与颜色主题无关；需通过命令面板选择图标主题，而非仅修改settings.json；Windows用户需安装Nerd Fonts补丁字体并配置editor.fontFamily；非标准扩展名需手动映射图标关联。
图标包必须单独安装，和颜色主题不是一回事
VSCode 默认只显示极简的文件夹和文档图标，所有带颜色、形状、框架标识的文件图标都来自第三方图标包扩展。它和 Color Theme 完全独立：装了 One Dark Pro 主题，不代表文件图标会自动变 Material 风格；反之亦然。
常见错误现象包括：资源管理器里全是默认小方块、.env 或 Dockerfile 没有专属图标、点击文件名左侧没反应——这些基本都能定位到图标包压根没装，或装了但没启用。
- 必须通过扩展市场安装，不能手动复制
.vsix或拖入extensions/目录（除非你在本地调试） - 最稳妥的选择是
Material Icon Theme（ID：material-icon-theme）或vscode-icons（ID：vscode-icons），二者更新勤、兼容性好 - 安装后不会自动启用，右下角不显示「已启用」标签就等于白装
启用图标包必须走命令面板，settings.json 仅作备份
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Preferences: File Icon Theme 并回车，从列表中选中你刚装的那个——这是唯一可靠的启用路径。
为什么不能只靠 settings.json？因为 VSCode 的启用状态存在用户元数据里，不写进 JSON。你写了 "workbench.iconTheme": "material-icon-theme" 却没装扩展，VSCode 不报错，而是静默回退到空图标；写了但 ID 拼错（比如写成 material-icon-them），同样无提示、无 fallback。
- ID 必须完全匹配扩展页右上角显示的「Identifier」字段，大小写、连字符一个都不能错
- 工作区设置（
.vscode/settings.json）优先级高于用户设置，适合团队统一图标风格 - 改完保存后图标立刻刷新，无需重启或重载窗口
图标显示为方块 □？先查字体，再查扩展冲突
尤其在 Windows 上，装完图标包却看到满屏方块，90% 是字体不支持 Unicode 符号。VSCode 图标依赖 Nerd Fonts 补丁字体里的额外 glyph（比如文件夹箭头、框架 logo），系统原生 Consolas 或 Cascadia Code 不带这些。
解决路径很明确：
- Windows 用户装
FiraCode Nerd Font或Cascadia Code PL，然后在设置里搜editor.fontFamily，填入'FiraCode Nerd Font', 'Consolas', monospace - Linux 用户装完字体后必须运行
fc-cache -fv刷新缓存，否则 VSCode 读不到新字体 - 检查是否同时启用了两个图标包（比如
vscode-icons和Tabler Icons），VSCode 不报错，但后者会静默覆盖前者
某些文件没图标？手动映射扩展名才管用
像 .env、.editorconfig、Dockerfile 这类非标准扩展名，很多图标包默认不识别。Material Icon Theme 就不给 .env 单独配图标，而是归到通用 config 类里——你得自己告诉它该用哪个。
打开用户或工作区 settings.json，加一段映射：
{ "material-icon-theme.files.associations": { "*.env": "config", "Dockerfile": "docker", ".editorconfig": "config" } }
注意：material-icon-theme.files.associations 是 Material Icon Theme 特有的配置项；vscode-icons 用的是 vsicons.associations.files，值格式也不同。别抄错。
另外，图标只在「已打开文件夹」下生效——用 File > Open File 打开单个 JS 文件，资源管理器根本不会出现，图标自然也不显示。
