图标丢失八成因当前主题未加载AFileIcon规则；需切换至AFileIcon Dark/Light等专用主题，或在Material/ayu主题中配置对应开关，并手动执行Rebuild Icons重建缓存。
装了多套主题后侧边栏图标丢失，八成不是插件冲突，而是当前启用的主题没加载 A File Icon 的图标规则——它不自动继承，必须显式支持或手动注入。
为什么换主题后图标突然没了
A File Icon 本身不提供 UI 渲染逻辑，只往侧边栏 DOM 元素里加 icon-js、icon-folder 这类 class；真正决定“是否显示图标”的，是当前激活的 .sublime-theme 文件里有没有对应 CSS 规则。装了多个主题（比如 Material、ayu、AFileIcon Dark），但没在 Preferences → Theme… 里选中那个带图标的，图标就永远空白。
- Adaptive.sublime-theme 默认不定义任何
.icon-*样式，哪怕 A File Icon 已启用也白搭 - 第三方主题如 Material Theme 或 ayu，需额外配置才能识别 A File Icon 的 class（例如 Material 需设
"material_theme_big_fileicons": true） - 误在
ignored_packages里加了"Default"或"Theme - Default"，会导致所有主题资源加载中断，图标 class 彻底失效
如何确认当前主题是否支持图标
最直接的方法是打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入 UI: Select Theme，然后选一个明确带 AFileIcon 字样的主题（如 AFileIcon Dark.sublime-theme）。这是最稳路径，无需额外配置。
- 若坚持用 Material Theme：必须在
Preferences → Settings – User顶层加"material_theme_big_fileicons": true - 若用 ayu 主题：需确保已安装
ayu包，并在主题设置中选ayu-dark.sublime-theme或ayu-light.sublime-theme，再运行A File Icon: Rebuild Icons - 检查控制台（
Ctrl+`）是否有类似error: Unable to open .../A%20File%20Icon/icons/file_type_js.png的报错，说明主题试图加载图标但路径失败（常见于插件文件夹名含空格或权限问题）
重建图标缓存必须做，且不能跳过
换主题后图标不出现，不是“缓存旧了”，而是新主题下 SVG 资源压根没下载、class 没注入。必须手动触发重建，否则 DOM 里只有文件名，没有 icon-* class。
- 按
Ctrl+Shift+P输入A File Icon: Rebuild Icons并回车 - 观察控制台输出，等出现
Finished rebuilding icons才算完成 - 若卡住或报
AFileIcon: failed to inject icon classes，先检查网络（公司代理常拦截packagecontrol.io），再确认 Sublime Text 版本 ≥ 4.4192 - 执行完建议完全退出 Sublime 再重开——热加载可能漏掉 theme 资源重载
自定义扩展名映射写错一个字符就失效
想让 .astro 显示 HTML 图标、.env 显示齿轮图标，必须在 Preferences → Package Settings → A File Icon → Settings – User 里配置，格式极其敏感：
- 键名必须小写、无点（
"astro"✅，".astro"❌，"ASTRO"❌） - 值必须是 A File Icon 内置图标名（
"html"、"gear"、"config"），不能填路径或自定义字符串 - 必须包在
"file_extensions"对象里，且 JSON 格式合法（末尾不能多逗号，括号要闭合） - 改完保存后，必须再运行一次
A File Icon: Rebuild Icons，否则映射不生效
真正容易被忽略的是：图标只出现在侧边栏，标签页顶部、搜索结果、预览窗格里都不会显示——这不是 bug，是 Sublime 的渲染机制限制，别在这儿浪费时间排查。
