图标不显示需手动执行a file icon: rebuild icons命令，该命令强制重载svg资源、扫描主题支持的icon class并注入dom；执行前须确认file_icons为true、当前ui主题支持图标class、未禁用default或theme-default包。
为什么图标突然不显示了？先确认是否触发了重载条件
Sublime Text 的图标（尤其是侧边栏文件图标）不是实时监听变化的，它只在启动时加载一次主题资源、在执行特定命令时重建图标映射。如果你改了 A File Icon 的用户配置、更新了插件、切换了 UI 主题，或者发现图标变问号/全灰/只剩文件夹图标，大概率是缓存没刷新或注入未完成——这时候不能靠重启解决，得手动重载。
A File Icon: Rebuild Icons 是唯一可靠重载方式
这个命令会强制重新下载 SVG 图标资源、扫描已安装的 UI 主题中支持的 icon class、并把图标类名注入到侧边栏 DOM 元素上。不运行它，哪怕你改对了所有配置，图标也不会出现。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
A File Icon: Rebuild Icons，回车执行 - 看底部状态栏或控制台（
Ctrl+`）是否有进度提示；若卡住或报AFileIcon: failed to inject icon classes，说明 Sublime 版本低于4.4192或网络受限 - 执行成功后，无需重启，但需手动展开/折叠一次侧边栏，或切换项目以触发 DOM 重绘
重载前必须检查的三项硬性前提
很多用户反复执行 Rebuild Icons 却无效，其实是底层依赖没满足。顺序检查比重装更省时间：
-
file_icons必须为true：在Preferences → Settings – User中确认顶层有"file_icons": true，不是嵌套在其他对象里 - 当前启用的 UI 主题必须支持图标 class：比如
Adaptive.sublime-theme、AFileIcon Dark.sublime-theme或新版Material Theme；Default、Slush & Poppies等默认主题不识别icon-js这类 class -
ignored_packages不能禁用Default或Theme - Default：一旦禁用，主题 CSS 资源链断裂，图标 class 有但无样式渲染入口
自定义扩展名图标生效也依赖重载
你在 Preferences → Package Settings → A File Icon → Settings – User 里加了 {"file_extensions": {"astro": "html"}}，这不会自动生效。A File Icon 只在 Rebuild Icons 阶段读取该配置并生成对应 class 映射。
- 保存配置后，必须再次运行
A File Icon: Rebuild Icons - 如果之前已运行过，且图标仍不对，可临时删掉
Packages/User/AFileIcon/下所有缓存文件（如icons/目录），再重建 - 扩展名写法不含点（
"astro"✅，不是".astro"❌），图标类型名必须是插件内置支持的（如"html"、"javascript"），拼错会 fallback 到文档图标
重载图标这事，核心就一条：别信“改完就生效”，A File Icon: Rebuild Icons 是开关，不是可选项。漏掉它，所有配置都只是躺在 JSON 里的静态文本。
