VSCode装了图标扩展但文件树仍为默认图标，大概率因未手动启用主题或workbench.iconTheme配置ID错误；需通过命令面板选择主题，且ID必须与扩展标识符严格一致，如"vscode-icons"。
装了扩展但文件树还是默认文档图标？大概率是没手动启用主题，或者 workbench.iconTheme 配置值写错了 ID。
为什么装了 vscode-icons 却没图标？
VSCode 不会自动激活图标主题扩展——安装 ≠ 启用。即使扩展面板里显示「已安装」，只要没通过命令或设置选中它，workbench.iconTheme 就不会生效。
- 检查是否误选了
None：按Ctrl+Shift+P输入Preferences: File Icon Theme，确认当前高亮项不是None - ID 必须和扩展实际注册的 ID 严格一致：
vscode-icons和material-icon-theme是两个不同扩展，不能混用；拼成vscode_icons或material-icon-them都会失败 - 远程开发（SSH/WSL/Containers）场景下，扩展必须在远程端安装并启用，本地装了无效
- 某些极简颜色主题（如
Minimal Theme）会主动禁用图标渲染，临时换回Default Dark+可验证是否为此原因
settings.json 里怎么写才生效？
配置必须写在用户设置或工作区设置中，且只接受字符串值，不能为 null 或空字符串。
- 正确写法：
"workbench.iconTheme": "vscode-icons"（ID 来自扩展页面右上角的 “Identifier” 字段） - 错误写法：
"workbench.iconTheme": null、"workbench.iconTheme": ""、"workbench.iconTheme": "VsCode Icons" - 多根工作区中，某个子文件夹的
.vscode/settings.json若含"workbench.iconTheme": null，会导致该文件夹图标退回到默认样式 - 改完保存后立即生效，无需重启 VSCode；若无效，执行
Developer: Reload Window比全量重启更快
如何让 .env、.astro 这类文件也显示图标？
图标主题自带映射有限，自定义需依赖扩展自身支持的字段名和图标标识符，写错字段或图标名就白搭。
-
vscode-icons用vsicons.associations.files；material-icon-theme用material-icon-theme.files.associations——字段名不通用 - 图标名必须是主题实际内置的，比如
"*.env": "tune"中的tune要查该主题 GitHub README 的 icon list，写成tune-icon或env都不识别 - 示例（
material-icon-theme）："material-icon-theme.files.associations": { "*.env.local": "angular", "Dockerfile": "docker", "pnpm-lock.yaml": "pnpm" } - 新增映射后，资源管理器不会自动刷新图标，需手动点击任意文件夹再点回来，或执行
Developer: Reload Window
最容易被忽略的是：图标主题的加载优先级低于颜色主题，也受设置层级影响（用户 > 工作区 > 文件夹）。哪怕只在一个子项目里图标异常，也要去它的 .vscode/settings.json 里翻一遍 workbench.iconTheme 是否被覆盖或设为 null。
