vscode图标包安装后必须手动启用，否则不生效；需通过命令面板选择preferences: file icon theme并确认配置workbench.icontheme，同时注意工作区设置覆盖、远程开发同步及主题与图标包分离配置。
图标包不是装完就生效，必须手动启用
VSCode 不会自动激活刚安装的图标扩展，这是设计行为，不是 bug。即使你看到扩展已“启用”状态，资源管理器里仍显示默认方块图标——因为 workbench.iconTheme 配置项压根没被写入，或者被工作区设置静默覆盖。
正确做法是：安装完图标扩展后，必须执行一次命令面板操作：
- 按
Cmd + Shift + P（macOS）或Ctrl + Shift + P（Windows/Linux）打开命令面板 - 输入并选择
Preferences: File Icon Theme - 从下拉列表中**点选一次**你刚装的主题（比如
material-icon-theme），哪怕它看起来已经高亮了
这一步会往 settings.json 里写入 "workbench.iconTheme": "material-icon-theme"，否则图标永远不会出现。
Material Icon Theme 是当前最稳的图标包选择
它覆盖 .ts、.json、.env、.dockerfile、.yml 等 100+ 文件类型，图标扁平、低饱和、高 DPI 下清晰，且支持自定义文件夹颜色和图标映射。相比 vscode-icons，它更轻量、更新更勤，对远程开发（Dev Container / Codespaces）兼容性更好。
装完启用后，建议加这几行到 settings.json 提升实用性：
-
"material-icon-theme.folders.color": "#6c5ce7"—— 给文件夹上色，避免和深色主题侧边栏背景融为一体 -
"material-icon-theme.hideFoldersArrows": true—— 关掉小箭头，视觉更干净 -
"material-icon-theme.showUpdateMessage": false—— 屏蔽烦人的更新提示 -
"material-icon-theme.files.associations": { "docker-compose.yml": "docker" }—— 把特定文件名映射到语义图标
注意：别开 saturation 或 opacity 调节，4K 屏上会让图标边缘发虚。
别踩这些图标不显示的典型坑
90% 的“图标没变”问题，其实跟扩展本身无关，而是配置冲突或路径错误：
- 检查
.vscode/settings.json（工作区级）是否锁定了"workbench.iconTheme"，它会强制覆盖全局设置，且界面毫无提示 - 用 GitHub Codespaces 或 Dev Container 时，容器内自带的
settings.json可能也带锁定项，得进去删 - 如果用了
Peacock或Theme Switcher这类主题管理插件，它们会劫持图标配置，临时禁用再试 -
Custom CSS and JS Loader这类插件会破坏所有图标渲染逻辑，2026 年起 VS Code 原生workbench.colorCustomizations已足够安全，没必要用它
重启 VSCode 时，务必选 Developer: Reload Window，而不是只重载设置——图标资源只在窗口初始化阶段加载一次。
搭配主题时注意 color theme 和 icon theme 的分离逻辑
很多人以为装了 One Dark Pro 就自动配好图标，其实完全不是一回事：color theme 控制编辑器/侧边栏/状态栏颜色，icon theme 只管资源管理器里的小图标，两者独立安装、独立启用、独立配置。
常见错配现象：
- 用了冷色系主题（如
Nord）却配暖色图标包，视觉割裂 - 启用了
vscode-great-icons却没关掉它的folderType功能，导致/src文件夹名被火箭图标盖住 - 在
settings.json里漏写了引号，比如写成workbench.iconTheme: material-icon-theme（缺引号 → 配置无效）
真正省心的组合是：One Dark Pro + material-icon-theme，或 Nord + vscode-great-icons（后者专为 Nord 冷色调优化过配色）。别迷信“UI theme”类扩展，VS Code 1.80+ 已彻底移除支持。
