图标包需手动启用且易被配置覆盖，正确方法是通过命令面板选择图标主题；material-icon-theme需额外配置文件关联、透明度等参数才能发挥效果。
装了图标包却看不到文件图标？大概率是只安装没启用，或者被 settings.json 里的显式配置覆盖了。
为什么装了 Material Icon Theme 或 vscode-icons 还是显示默认小方块？
图标包扩展本身不自动激活——安装只是把代码放进本地目录，真正生效要靠 workbench.iconTheme 配置项指向它。常见失效原因包括：
-
settings.json里存在"workbench.iconTheme": null或"workbench.iconTheme": ""，这会强制禁用所有图标主题 - 工作区级设置（
.vscode/settings.json）覆盖了用户级设置，优先级更高 - 打开的是单个文件（
File > Open File），而非文件夹（File > Open Folder），图标主题在单文件模式下通常不加载 - Remote-SSH 连接时，图标包必须在远程 VS Code Server 环境中单独安装，本地装了无效
如何正确启用图标包：命令面板比设置界面更可靠
GUI 设置界面有时会卡住或未实时写入配置，推荐用命令面板操作，确保状态写入且立即生效：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Preferences: File Icon Theme，回车 - 从弹出列表中选择目标图标包，如
Material Icon Theme或vsicons - 无需重启，资源管理器图标会秒级刷新
注意：如果列表里没有你刚装的图标包，说明安装失败或扩展被禁用，回到扩展视图检查状态。
material-icon-theme 的常用自定义项别漏配
这个图标包提供不少实用微调，但默认关闭，需要手动开启才能发挥全部效果：
- 想让文件夹前带展开箭头？启用
material-icon-theme.showFolderArrows - 希望
.env、Dockerfile等特殊文件有专属图标？在settings.json中加映射："material-icon-theme.files.associations": { "*.env": "config" } - 图标颜色太刺眼？调低
material-icon-theme.opacity（0.1–1.0）或material-icon-theme.saturation（0–2） - 某些文件夹（如
src、docs）想高亮？用命令Material Icon Theme: Set Folder Color单独上色
这些配置不会影响性能，但能显著提升项目结构辨识度——尤其在几十个同名 index.ts 散落在不同子目录时。
图标包和主题配不搭？先看作者是否成对发布
视觉割裂常不是 Bug，而是组合随意导致的。比如深色主题配浅色图标，或图标轮廓被侧边栏背景“吃掉”：
- 优先选同源组合：
One Dark Pro主题 +One Dark Pro Icon（非官方但适配好）、Material Theme+Material Icon Theme - 避免混搭冷暖色调极端的主题，例如
Nord（蓝灰冷调）配Tabler Icons（偏橙黄暖色） - 若图标文字看不清，检查
workbench.colorCustomizations是否意外覆盖了sideBar.foreground，导致图标颜色与文字色冲突
最常被忽略的一点：图标包的启用状态不写进 settings.json，而是存在 VS Code 用户元数据中。迁移配置或重装系统时，光备份 JSON 文件，图标会立刻回归默认——得一并导出已启用扩展列表。
