a file icon 插件不显示图标主因是未启用支持图标的ui主题，它仅注入css类（如icon-file-type-js），图标渲染由主题决定；须手动通过ui: select theme选择material、ayu或afileicon系列主题，并在settings–user顶层设"file_icons": true，再执行purge icon cache和rebuild icons。
为什么装了 A File Icon 还没图标？主题没选对
插件本身不画图标，它只是给侧边栏元素加 icon-file-type-js 这类 class；真正决定“画不画”“画成什么样”的，是当前启用的 UI 主题。只装插件不换主题，等于买了颜料但没 canvas。
必须手动切换主题：按 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、.tfvars，就得手动映射。但格式极敏感，错一个字符整块配置就静默失效。
打开 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"}
图标不刷新？别重启，先清缓存再重建
改完设置或升级插件后图标不动，90% 是缓存卡住了。反复重启 Sublime 不解决问题，反而浪费时间。
按 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 元素，不会影响标签页顶部、文件预览区、Goto Anything 搜索结果等区域。
这是插件明确的设计边界，不是兼容性缺陷。想让标签页也有图标，得用别的方案（比如 CustomizeUI + CSS 注入），但稳定性差、Sublime Text 4 后期版本支持不一，不推荐普通用户折腾。
最易被忽略的一点：图标渲染依赖 PNG 文件路径和尺寸。如果你手动改过 .sublime-theme，确保替换的图标是 16×16 或 32×32 的 .png，且 layer0.texture 路径指向主题包内相对位置，不能是绝对路径或 URL。
