图标不显示需先手动启用主题并重载窗口：按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），执行Preferences: File Icon Theme选中主题，再点Reload Window；若仍无效，检查工作区设置是否覆盖、files.associations是否精准映射、图标ID是否匹配插件内置定义。
图标不显示？先确认主题已启用且没被覆盖
装完 Material Icon Theme 或 vscode-icons 后图标还是默认文档样式，90% 是因为 VSCode 坚决不自动启用——你必须手动选一次主题，workbench.iconTheme 才会写进配置生效。
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行 Preferences: File Icon Theme，从列表中选中你要的主题（比如 Material Icon Theme），然后点右下角弹出的 Reload Window。漏掉重载，所有后续自定义都白配。
常见错误现象：
-
settings.json里写了"workbench.iconTheme": "material-icon-theme"却没效果 → 没重载窗口 - 资源管理器里部分文件夹图标变了、部分没变 → 工作区
.vscode/settings.json里有"workbench.iconTheme": null，它会强制覆盖用户设置 - 命令面板里根本找不到你装的主题 → 插件没装成功，或 ID 拼错（正确 ID 是
material-icon-theme，不是material-icon或带空格）
想让 .env.local 显示锁图标？用 files.associations 精确匹配
Material Icon Theme 默认只认最后一段后缀（比如 .cjs、.gitignore），像 .env.local、.prettierrc.cjs 这种多段后缀会被忽略，必须手动映射。
在 settings.json 中加 "material-icon-theme.files.associations"，注意键名必须带点、值必须是插件支持的图标 ID：
- ✅ 正确：
".env.local": "lock"、"*.test.js": "javascript-react" - ❌ 错误：
"env.local": "lock"（缺点）、".env.*": "lock"（Material Icon Theme不支持通配符星号在中间） - 图标 ID 必须查插件源码里的
iconDefinitions.json，别瞎猜 ——lock行，dotenv不行
如果你用的是 vscode-icons，对应字段是 "vsicons.associations.files"，写法类似但参数名不同："extensions": ["env.local"]（注意这里不带点，只写后缀名）。
tsconfig.dev.json 怎么显示 TypeScript 配置图标？两步缺一不可
.tsconfig.json 默认被 VSCode 当成 JSON 文件解析，所以图标是通用 JSON 图标；要让它显示 TypeScript 配置专属图标，得同时做两件事：
- 用
files.associations告诉 VSCode：“这个文件内容其实是 TypeScript 配置”，例如："*.tsconfig.json": "typescript" - 再用图标主题的关联字段绑定图标，例如
vscode-icons用：{"icon":"typescript-config","extensions":["tsconfig.json"],"format":"svg"}
关键点：
-
files.associations支持通配符（*.tsconfig.json），但图标映射字段（如extensions）只接受精确字符串（"tsconfig.json"） - 改了文件名（比如从
tsconfig.json改成tsconfig.dev.json）后图标变回默认，就是因为没同步更新extensions列表 - 两个配置必须都存在，缺一个图标就 fallback 到默认
后端文件夹如 back_end、backends 怎么统一显示服务器图标？
Material Icon Theme 默认只给 backend 文件夹配了 server 图标，但实际项目里常有 back_end、backends、back_ends 等变体。解决方法是用用户级配置覆盖：
- 在
settings.json中添加："material-icon-theme.folders.associations": {"back_end": "server", "backends": "server", "back_ends": "server"} - 注意：键名是完整文件夹名，不带路径；值必须是插件内置图标 ID（
server可用，backend不行） - 这种配置优先级高于插件默认规则，且插件升级不会丢失
- 团队项目建议写进
.vscode/settings.json，保证所有人看到一致结构
真正容易被忽略的是：图标主题的匹配逻辑完全基于名称字符串，不涉及文件内容或语言服务。哪怕你把 back_end 文件夹里全删光，只要名字还在，图标就一直显示为服务器。
