为什么装了 A File Icon 还没图标？主题没选对
先明确一个核心概念：A File Icon 插件本身并不负责“画”出图标。它的工作，是给侧边栏里的文件元素加上特定的 CSS 类名，比如 icon-file-type-js、icon-file-type-python。那么，谁来根据这些类名把图标画出来呢？答案是当前启用的 UI 主题。这就好比，插件只提供了颜料和配方，而画布和画笔掌握在主题手里。如果主题不支持，图标自然无处显现。
所以，安装插件后的第一步，必须是手动切换到一个支持图标的主题。操作很简单：按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），调出命令面板，输入 UI: Select Theme，然后从列表中选择名称里带有 “Material”、“Ayu” 或 “AFileIcon” 字样的主题。例如，Material-Theme.sublime-theme 或 Ayu.sublime-theme 都是常见的选择。
这里有几个新手常踩的坑：
- 以为安装完插件就万事大吉，没有进入主题菜单进行手动选择。
- 使用了 Soda、Flatland 等较老的主题，这些主题根本没有定义
icon-file-type-*相关的样式规则。 - 在用户设置（Settings – User）里写死了
"theme": "Default.sublime-theme"，这行配置会强制覆盖你刚才选择的主题，导致切换失效。
自定义 .env、.conf 等小众后缀图标要写对 JSON 格式
插件自带的图标库虽然丰富，但也不可能覆盖所有文件后缀。像 .env.local、.conf、.tfvars 这类相对小众的扩展名，就需要我们手动建立映射关系。不过，自定义配置的 JSON 格式非常敏感，错一个标点或大小写，整段配置就可能静默失效。
正确的做法是：打开 Preferences → Package Settings → A File Icon → Settings – User，在文件中填入如下格式的内容：
{
"file_extensions": {
"env": "gear",
"conf": "gear",
"tfvars": "terraform"
}
}
这里有三个细节必须注意：
- 键名规则：必须是小写、且不带点号的纯扩展名字符串。写
"env"是对的，写".env"或"ENV"就不行。 - 值域限制：等号右边的值，必须是插件内置的图标名称，比如
"gear"（齿轮）、"html"、"folder"等。不能随意填写其他单词（如"cog"），也不能指向外部 SVG 或图片路径。 - 结构嵌套：整个映射关系必须包裹在
"file_extensions"这个对象里。直接写{"env": "gear"}是无效的。
图标不刷新？别重启，先清缓存再重建
修改了设置，或者升级了插件版本，却发现侧边栏图标纹丝不动？别急着反复重启 Sublime Text，这通常不是软件本身的问题。90% 的情况，是图标缓存没有及时更新。重启并不能清除缓存，反而浪费了时间。
高效的解决流程是：按下 Ctrl+Shift+P 调出命令面板，然后依次执行下面两个命令：
A File Icon: Purge Icon Cache—— 彻底清空旧的图标缓存。A File Icon: Rebuild Icons—— 基于当前配置重新生成图标资源。
这两步完成后，当前已打开的项目侧边栏通常会立即刷新。如果图标仍然不显示，那就得检查一下 ignored_packages 设置列表里，是否不小心把 "A File Icon" 给加进去了。
图标只出现在侧边栏，其他地方没有是正常设计
经常有人搜索“为什么 Sublime 标签页没有文件图标？”，其实这并非 Bug。需要明确的是，A File Icon 插件的 class 注入逻辑，其作用范围仅限于侧边栏的 DOM 元素。因此，文件标签页（Tab）、文件内容预览区、以及 Goto Anything 的搜索结果区域，都不会显示这些图标。
这是插件明确的设计边界，而非兼容性缺陷。如果确实希望标签页也能显示图标，就需要借助其他方案（例如结合 CustomizeUI 插件进行 CSS 注入），但这类方案稳定性较差，尤其在 Sublime Text 4 的后续版本中支持度不一，并不推荐普通用户折腾。
最后补充一个容易被忽略的技术点：图标渲染最终依赖于 PNG 图片文件的路径和尺寸。如果你曾手动修改过 .sublime-theme 主题文件，请确保你替换的图标是 16×16 或 32×32 的 PNG 格式，并且 layer0.texture 指向的是主题包内的相对路径，而不能是绝对路径或网络 URL。
