必须先安装图标扩展并严格匹配其发布ID，再通过命令面板启用主题或在settings.json中配置workbench.iconTheme值；自定义文件图标需按扩展要求使用合法图标ID映射，改完须重载窗口生效。
workbench.iconTheme 配置必须匹配扩展 ID
图标主题不会自动生效，根本原因是 workbench.iconTheme 的值必须和已安装扩展的 **发布 ID** 完全一致，拼写、大小写、连字符一个都不能错。
-
material-icon-theme是 Material Icon Theme 的真实 ID（作者 Equinusocio / PKief），不是Material Icon Theme或material-theme -
vscode-icons是 vscode-icons 的 ID（作者 Roberto Huertas），不是vscode-icons-theme或vscodeicons - 装了扩展但没启用，
workbench.iconTheme依然无效——去扩展面板确认右下角显示“已启用”，而非“禁用” - 该配置只在用户设置或工作区
.vscode/settings.json中生效；写在其他地方（比如插件自己的 JSON）会被忽略
material-icon-theme.files.associations 映射规则要严格对齐图标名
自定义文件图标时，键是文件路径/扩展名模式，值是图标主题内部定义的图标 ID —— 不是随便起的名字，也不是文件类型名。
- 支持通配符：
"*.env.local": "gear"、"Dockerfile.*": "docker"有效；但"Dockerfile.*.prod"不匹配，因为通配符不嵌套 - 值必须来自主题已有的图标 ID：查 GitHub icons/ 目录，文件名去掉
.svg就是合法 ID（如lock.svg→"lock"） - 写错 ID（比如写成
"env"或"config-file"）不会报错，而是静默回退为默认问号图标 - 改完需重载窗口（
Developer: Reload Window），否则已有打开的资源管理器不刷新
vscode-icons 的自定义方式完全不同
vscode-icons 不走 files.associations，它用的是 vsicons.associations.files 和 vsicons.associations.folders，且结构更灵活。
- 示例配置：
"vsicons.associations.files": { "*.myext": "typescript", "pnpm-lock.yaml": "pnpm" } - 它还支持语言 ID 映射：
"vsicons.associations.languages": { "astro": "astro" }，前提是 VS Code 已识别该语言 - 文件夹映射可基于名称（
"src"）或内容特征（如含package.json自动用 JS 图标），但自定义 folder 名称必须写进vsicons.associations.folders - 预设切换（如
vsicons.presets.angular）会影响默认映射，自定义规则优先级高于预设
图标不显示？先排除这三类干扰
不是配置写错了，而是环境或冲突挡住了图标渲染。
- 当前颜色主题禁用了图标：某些极简主题（如
Minimal Theme）会主动关闭图标显示，换回Default Dark+测试是否恢复 - 工作区设置覆盖了用户设置：
.vscode/settings.json里有"workbench.iconTheme": null或空字符串，会强制关掉图标 - 多个图标扩展共存：同时启用
material-icon-theme和vscode-icons时，只有最后一个启用的生效，其余被忽略
真正卡住人的从来不是怎么写配置，而是不知道哪个环节悄悄绕过了你的设置。ID 拼错、扩展没启用、值不在图标池里、或者另一个扩展正在后台抢权——这些细节不手动验证一遍，光看文档永远调不好。
