vscode本身不决定文件图标，图标由图标主题扩展渲染；你只能告诉它“这个后缀属于哪类语言”，再靠主题把语言id映射到具体图标。
VSCode 本身不决定文件图标，图标由图标主题扩展渲染；你只能告诉它“这个后缀属于哪类语言”，再靠主题把语言 ID 映射到具体图标。
为什么 .env 文件没齿轮图标？
VSCode 默认把 .env 当作纯文本，language ID 是 plaintext，而绝大多数图标主题（如 vscode-icons 或 material-icon-theme）根本不为 plaintext 配齿轮图标。它只认语义明确的 language ID，比如 shellscript、json、typescript。
- 直接写
"*.env": "gear"在files.associations里完全无效——gear不是合法 language ID，VSCode 会静默忽略 - 正确做法是映射到已有 language ID：
"*.env": "shellscript"（用 shell 图标）或"*.env": "json"（用 JSON 图标），再靠图标主题自身规则决定是否显示齿轮 - 如果你用的是
vscode-icons，它额外支持vsicons.associations.files直接绑定图标名，但必须配"extensions": ["env"]（不是[".env"]），且icon值必须是它文档里列出的合法值，比如"gear"、"config"
自定义后缀（如 .api）怎么绑定图标？
VSCode 对不认识的后缀默认走 plaintext，图标就是空白页。想让它有图标，核心是「复用」而非「新建」——别折腾注册新 language，除非你真需要语法高亮和 LSP 支持。
- 最简单：在
files.associations里映射到语义接近的已有 language ID，例如"*.api": "json"（显示 JSON 图标）或"*.api": "yaml"（显示 YAML 图标） - 如果项目里
.api实际是 OpenAPI 格式，更推荐"*.api": "json"+ 安装Red Hat YAML或Swagger Viewer扩展来补足校验能力 - 千万别映射到强语法语言如
javascript，会导致格式化错乱、自动补全误触发、括号匹配异常——图标对了，编辑体验反而崩了
material-icon-theme 和 vscode-icons 的配置差异
两个主流图标主题处理自定义的方式完全不同，混用会失效。
-
material-icon-theme只响应material-icon-theme.files.associations，例如："material-icon-theme.files.associations": { "*.env": "gear" }它不看files.associations里的映射，也不支持vsicons.associations.files -
vscode-icons只响应vsicons.associations.files，例如："vsicons.associations.files": [ { "icon": "gear", "extensions": ["env"], "format": "svg" } ]它不读material-icon-theme的字段，也不依赖files.associations来决定图标（但files.associations影响语法高亮） - 同时启用两个图标主题时，VSCode 只生效最后一个启用的——删掉一个，否则白配
改完配置图标还不变？这几个地方最容易漏
图标不刷新，90% 不是配置写错了，而是环境没到位。
- 确认图标主题已启用：运行
Preferences: File Icon Theme，检查当前选中项不是None - 检查工作区设置覆盖：打开
.vscode/settings.json，确认没有"workbench.iconTheme": null这类强行禁用的配置 - 远程开发场景下，图标主题必须装在远程端（SSH / WSL / Container），本地装了没用
- 某些主题（如
vscode-icons）要求重启窗口才加载新vsicons.associations.files规则，按Ctrl+Shift+P→Developer: Reload Window比关掉重开更快
真正卡住人的从来不是怎么写那几行 JSON，而是 language ID、图标主题、扩展启用状态三者之间的隐式依赖关系——少一环，图标就停在空白页上不动。
