FileIcons插件需配合支持右侧图标的UI主题（如Material-Theme）才能显示图标，否则仅显示固定小图标；常见失效原因包括主题禁用图标区域、图标资源加载失败、高DPI适配问题或CSS覆盖；安装后须检查ignored_packages、确认主题兼容性并重启编辑器。
Sublime Text 侧边栏默认不显示文件图标，装了 FileIcons 插件也不代表图标能立刻出现——它只是“叠加式美化”，必须配合支持图标的 UI 主题（比如 Material-Theme.sublime-theme）才能生效，否则只会在文件名后加一个极小的、颜色单一的图标，且不随文件类型变化。
为什么装了 FileIcons 还是没图标？
FileIcons 和 A File Icon 是两个不同插件：FileIcons 不注入 CSS 类，也不依赖主题图标规则，而是直接在文件名右侧插入固定尺寸的 PNG 图标；它轻量、启动快，但扩展性差、图标少、不支持冷门后缀映射。常见失效原因：
- 当前主题禁用了右侧图标区域（如某些精简版
Adaptive变体会隐藏.tree_row .icon） -
FileIcons自带的图标资源未加载成功，控制台（Ctrl+`）里可能出现FileIcons: failed to load icons - 你正在用高 DPI 显示器但插件没提供 @2x 图标，导致图标模糊或不渲染
- 其他插件（如
CustomizeUI或Origami）覆盖了.tree_row的 padding/margin，把右侧图标挤出可视区
FileIcons 安装后必须做的三件事
不同于 A File Icon，FileIcons 不需要 Rebuild Icons 命令，但有三个硬性动作缺一不可：
- 确认
Preferences → Settings – User中没有"ignored_packages": ["FileIcons"]—— 有就删掉 - 确保
"theme": "xxx.sublime-theme"指向的是一个**明确支持右侧图标的主题**，例如Material-Theme.sublime-theme或ayu-dark.sublime-theme；Default.sublime-theme和Slush & Poppies默认不预留右侧空间 - 重启 Sublime Text ——
FileIcons的图标注入发生在初始化阶段，热重载主题或改设置都不触发重绘
怎么让 .env、.dockerignore 这类文件也显示图标？
FileIcons 不提供 file_extensions 映射机制，它只认内置的约 80 种扩展名（见其 GitHub README 的 icons.json）。想让冷门后缀显示图标，只有两个办法：
- 手动编辑
Packages/FileIcons/icons.json，在"extensions"数组里加一行："env": "gear"—— 但下次插件更新会被覆盖 - 更稳妥的做法：卸载
FileIcons，改用A File Icon，然后在Packages/User/AFileIcon.sublime-settings里写：{"file_extensions": {"env": "gear", "dockerignore": "docker"}} - 注意右值（如
gear）必须是插件已声明的图标名，拼错就 fallback 成空白方块
FileIcons 和 A File Icon 到底该选谁？
如果你只需要快速加几个基础图标（.js、.py、.md），且不用深色/浅色自动切换、不关心文件夹颜色、不打算长期维护配置，FileIcons 启动快、无依赖、不卡顿。但只要涉及以下任一需求，就该换 A File Icon：
- 要让
.astro显示 HTML 图标，或.tf显示云朵图标 - 希望文件夹按语言分类着色（
colored_folders） - 用的是公司内网或离线环境，无法自动下载 SVG 缓存
- 主题经常切换，不想每次换主题都重新调图标位置
真正容易被忽略的点是：图标是否可见，从来不是插件单方面决定的；它是插件注入时机、主题预留空间、Sublime 渲染管线三者对齐的结果。哪怕所有配置都写对了，只要某次启动时 ST 加载顺序异常，图标就可能消失——这时别急着重装，先试 UI: Reload Theme。
