vs code 默认不显示文件夹图标，需安装 vscode-icons 或 material icon theme 等扩展，并通过 preferences: file icon theme 启用后重载窗口才能生效；若仍不显示，需检查颜色主题冲突、远程开发时扩展是否已安装到远程端，以及是否刷新资源管理器。
VS Code 默认不显示文件夹图标，需要装扩展
VS Code 原生只显示文件名和简单箭头（▶️），不渲染任何文件夹图标。这不是设置问题，而是功能缺失——它压根没内置图标支持。想看到 src、node_modules、dist 这类带图标的文件夹，必须靠第三方扩展。
实操建议：
- 装
vscode-icons（最常用，维护活跃，图标覆盖全）或Material Icon Theme（风格更扁平，配 Material 主题顺眼） - 装完后按
Ctrl+Shift+P（windows/linux）或Cmd+Shift+P（macos），输入Preferences: File Icon Theme，选中启用的图标主题 - 重启 VS Code 或重新加载窗口（
Developer: Reload Window）才能生效，仅启用不 reload 是看不到变化的
图标不显示？先检查是否被其他主题覆盖
常见错误现象：装了图标扩展，也选了主题，但文件夹还是没图标。大概率是当前使用的颜色主题（Color Theme）强行禁用了图标，比如某些极简主题（如 Nord、One Dark Pro 的精简版）会关掉 list.indent 或覆盖 list.rowHeight，间接导致图标不可见。
实操建议：
- 打开设置（
Ctrl+,），搜workbench.iconTheme，确认值不是NULL或空字符串 - 搜
workbench.colorTheme，临时切换成默认的default Dark+或Default Light+，看图标是否出现——如果出现了，说明原主题冲突 - 不想换主题？可在
settings.json中加一行："workbench.iconTheme": "vscode-icons"，强制指定，比 ui 设置优先级高
自定义文件夹图标映射要改 iconDefinitions
默认图标扩展只覆盖常见文件夹名（如 test、docs、scripts）。如果你有私有命名（比如 legacy、proto、infra），它们不会自动匹配图标，得手动配。
实操建议：
- 在
settings.json里加"vsicons.associations.folders"（vscode-icons）或"material-icon-theme.folders.associations"（Material 主题） - 例如让
legacy显示齿轮图标："legacy": "gear"；让proto显示文件图标："proto": "file" - 图标名必须是扩展支持的（查对应扩展的 github README，别瞎写——写错不会报错，只是不显示）
- 改完保存，不用重启，但要刷新资源管理器（右键空白处 →
Refresh）或重开文件夹
远程开发（ssh/WSL）下图标可能不加载
VS Code 远程场景中，图标扩展默认只装在本地端，而文件树渲染实际发生在远程端（Server），导致图标空白或回退为默认箭头。这不是 bug，是设计限制。
实操建议：
- 连接远程后，在远程窗口的扩展面板里，找到已安装的图标扩展（如
vscode-icons），点「Install in SSH: xxx」按钮单独安装到远程 - 别依赖“同步扩展”选项——它只同步启用状态，不保证远程端真正安装成功
- 装完后仍不显示？检查远程端 VS Code 版本是否 ≥ 1.70（老版本对远程图标支持不完整）
图标映射逻辑藏在扩展内部，改配置只是“告诉它用哪个”，不是“画一个”。很多人卡在以为改了 JSON 就该立刻生效，其实漏了 reload 或远程重装这步。