VSCode侧边栏文件图标不显示，主因是文件未被正确识别为对应语言模式，而非插件缺失；files.associations仅映射后缀到语言ID，图标主题依赖该语言ID匹配图标，需检查状态栏语言模式、配置语法、主题支持及插件冲突。
VSCode 侧边栏文件图标不显示，大概率不是插件没装，而是文件类型没被正确识别——files.associations 配置错位、语言模式未触发、或图标主题本身不支持该后缀。
为什么 files.associations 不生效
这个设置只负责「把某个后缀映射到某种语言模式」，不直接控制图标。但图标主题（如 Material Icon Theme）依赖语言模式来决定用哪个图标。如果 .env 文件没被识别为 plaintext 或 shellscript，图标主题就无从匹配。
- 检查当前文件右下角状态栏：是否显示了正确的语言模式（比如
Plain Text）？没显示说明 VSCode 根本没识别它 -
files.associations是用户级或工作区级配置，写在错误位置（比如写进了settings.json的顶层对象外）会导致整个 JSON 解析失败，VSCode 会静默忽略 - 关联值必须是 VSCode 内置或已激活扩展提供的语言 ID，比如
javascriptreact合法，但jsx或js就无效
如何手动强制设置语言模式并验证图标
先绕过配置，直接验证图标是否真能显示：打开一个无后缀或异常后缀的文件 → 点击右下角语言模式 → 选择对应语言（如 JSON、Shell Script）→ 观察图标是否立刻出现。
- 如果此时图标出现了，说明图标主题本身支持该语言，问题出在自动识别逻辑上
- 如果仍不显示，换一个图标主题测试（如启用
vs-seti），排除主题兼容性问题 - 确认该语言 ID 是否被图标主题收录：查主题文档或 GitHub issues，例如
Material Icon Theme对dockercompose的支持是从 v4.10 才加入的
修复 files.associations 的典型写法
不要凭感觉写后缀，要严格按 VSCode 语法：键是字符串（带点），值是语言 ID（小写、无空格、全英文）。常见错误包括多写斜杠、漏引号、用错大小写。
{
"files.associations": {
"*.env": "shellscript",
".env.*": "shellscript",
"Dockerfile.*": "dockerfile",
"docker-compose.yml": "yaml",
"tsconfig.json": "jsonc"
}
}
-
"*.env"匹配所有.env后缀文件；".env.*"匹配.env.local这类复合后缀（注意点号要转义为字面量） -
dockerfile是语言 ID，不是Dockerfile；jsonc支持注释，比json更适合配置文件 - 修改后无需重启，但已打开的文件需重新加载（
Ctrl+R）或关闭再打开才能应用新关联
图标还是不显示？检查图标主题的启用状态和范围
有些图标主题默认禁用部分类型（比如隐藏 .gitignore、.editorconfig），或只对特定语言开启——这不是 bug，是主题作者的主观设计。
- 打开命令面板（
Ctrl+Shift+P），运行Material Icon Theme: Manage Icons，手动勾选需要显示图标的文件类型 - 确认主题是否支持当前工作区根目录下的文件：某些主题对子文件夹内同名文件（如
src/.env）不生效，需额外配置material-icon-theme.files.associations - 禁用所有插件，只留图标主题 + 官方语言支持插件，逐步启用排查冲突
最常被忽略的一点：VSCode 的文件图标渲染依赖「语言模式」而非「文件后缀」本身。哪怕你写了 "*.log": "plaintext"，如果某 app.log 文件被自动识别成了 Log（来自 Log File Highlighter 插件），而该语言 ID 没被图标主题收录，图标依然不会出现。
