VSCode需安装图标扩展并正确配置workbench.iconTheme及文件映射规则才能显示.env等专属图标；常见问题包括扩展ID错误、settings.json覆盖、远程端未安装扩展及映射键值格式不合法。
VSCode 默认不显示任何文件图标，必须安装扩展并正确配置才能让 .env、tsconfig.json、pnpm-lock.yaml 这类文件显示专属图标。光装插件不等于生效，90% 的“图标没变”问题出在映射规则写错或配置被覆盖。
怎么确认图标扩展真正在工作
装了 vscode-icons 或 material-icon-theme 不代表图标就出来了。VSCode 只认 workbench.iconTheme 这个设置项的值，且它必须和扩展 ID 完全一致：
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Preferences: File Icon Theme，看列表里有没有你装的扩展名（比如Material Icon Theme）——没有就说明扩展根本没装成功，或 ID 拼错了 - 检查
settings.json里是否写了"workbench.iconTheme": "vscode-icons"（注意不是vscode-icons-或带空格） - 右下角状态栏如果显示
Workspace Settings，说明当前文件夹有.vscode/settings.json，它会覆盖全局设置，得在里面也加一遍workbench.iconTheme - 按
Ctrl+Shift+P运行Developer: Toggle Developer Tools，在 Console 里搜icon，出现Failed to load icon theme就是 ID 或路径不对
material-icon-theme 怎么配文件名映射
这个扩展靠 material-icon-theme.files.associations 把完整文件名或扩展名映射到图标 ID，不是模糊匹配，也不支持通配符（除了 * 前缀）：
- 键必须带点：
".env.local"✅，env.local❌；"*.tsconfig.json"✅（用于files.associations），但图标映射里只能写"tsconfig.json" - 值必须是它内置的图标 ID：
"lock"✅，"lock.svg"❌；查可用 ID 最稳的方式是打开插件源码里的node_modules/material-icon-theme/icons/iconDefinitions.json - 常见合法 ID：
lock、config、settings、file、typescript-config，别瞎猜dotenv或pnpm - 示例（让锁文件统一用锁图标）：
"material-icon-theme.files.associations": { ".env.local": "lock", "pnpm-lock.yaml": "lock", "package-lock.json": "lock" }
vscode-icons 映射 .env 类文件的坑
这个扩展对 .env 文件的支持更“类型化”，需要两步走，缺一不可：
- 先用
files.associations告诉 VSCode 把.env当作某种语言解析（否则它永远归为plaintext）："files.associations": { ".env": "shellscript", ".env.local": "shellscript" } - 再用
vsicons.associations.files绑定图标，注意extensions字段只写后缀名，不带点："vsicons.associations.files": [ { "icon": "gear", "extensions": ["env", "env.local"], "format": "svg" } ] - 常见错误：
extensions写成[".env"]或["env"]拼错大小写，会导致整个映射失效，且无报错提示 -
tsconfig.json同理：需先"*.tsconfig.json": "typescript"，再映射"tsconfig.json"到typescript-config
远程开发（SSH/WSL）下图标不显示怎么办
VSCode 远程场景中，图标扩展默认只装在本地端，但资源管理器渲染发生在远程端，所以图标不会加载：
- 必须在远程端（SSH 主机或 WSL 发行版）里单独安装图标扩展：打开远程窗口后，进扩展视图（
Ctrl+Shift+X），搜material-icon-theme，点“Install in SSH: xxx” - 装完后仍不显示？检查远程端的
settings.json是否设置了workbench.iconTheme，本地设置不会同步过去 - 刷新资源管理器（右键空白处 →
Refresh）比重启窗口更快见效 - 如果远程端是容器（Docker Dev Container），还得确保
.devcontainer/devcontainer.json的customizations.vscode.extensions里列出了图标扩展 ID
最常被忽略的一点：图标映射配置（无论是 files.associations 还是 vsicons.associations.files）必须写在生效的 settings.json 里——用户级、工作区级、远程级三者优先级不同，改错地方等于白改。建议直接用命令面板打开 Preferences: Open Settings (JSON)，一眼看清当前生效的是哪一份。
