侧边栏图标不显示，八成是主题没切对：必须手动切换至afileicon dark/light.sublime-theme，且运行a file icon: rebuild icons命令，同时确保用户设置中正确配置file_extensions映射规则。
侧边栏图标不显示，八成是主题没切对
装了 AFileIcon 却没图标，不是插件没生效，而是 Sublime 没用它能识别的主题。插件只负责往 DOM 里加 icon-js、icon-folder 这类 class，真正画图标的，是主题里的 CSS 规则。
必须手动切换到 AFileIcon Dark.sublime-theme 或 AFileIcon Light.sublime-theme —— 安装完插件后默认不会自动切，仍停在 Adaptive.sublime-theme 或其他第三方主题上，图标 class 就被无视了。
切换方式：Preferences → Theme…，从下拉列表里选带 AFileIcon 前缀的项。别手贱去改 ignored_packages，误加 "Default" 或 "Theme - Default" 会直接让所有图标 class 失效。
A File Icon: Rebuild Icons 命令必须手动运行
插件安装或更新后，SVG 图标资源不会自动下载和缓存，必须显式触发重建。不运行这步，侧边栏永远是纯文本。
操作路径：Ctrl+Shift+P（macOS 用 Cmd+Shift+P）→ 输入 A File Icon: Rebuild Icons → 回车。控制台（Ctrl+`）会显示下载进度，完成后图标才可能浮现。
常见疏漏点：
- 以为装完就完事，跳过这步
- 网络受限导致 SVG 下载失败，控制台报
AFileIcon: failed to inject icon classes - ST 版本低于
4.4192，动态 class 注入机制不全，图标 class 被丢弃
检查图标 class 是否真注入进去了
图标没出现，先确认底层 class 到底有没有挂上去。打开一个文件（比如 index.html），右键侧边栏对应条目 → Inspect Element（需已启用 DevTools 插件，或用 ST 自带调试模式），看 DOM 元素是否含 icon-html、icon-folder 等 class。
没有？说明插件监听失败。排查步骤：
- 命令面板输入
A File Icon: Enable，确认状态为 enabled - 打开
Preferences → Package Settings → A File Icon → Settings，检查"enabled": true - 控制台（
Ctrl+`）搜AFileIcon，看有无注入失败报错
自定义扩展名图标要改用户配置，别碰插件自带 settings
想让 .astro 显示 HTML 图标，不能直接改插件目录下的 AFileIcon.sublime-settings —— 升级插件时会被覆盖。得改用户级配置：
打开 Preferences → Package Settings → A File Icon → Settings – User，加入：
{
"file_extensions": {
"astro": "html"
}
}
注意格式：key 是扩展名（不含点），value 是目标图标类型（如 html、js、folder）。改完不用重启，但建议再跑一次 A File Icon: Rebuild Icons 确保缓存刷新。
图标显示依赖链很短：插件注入 class → 主题匹配 class → 渲染 SVG。任一环断开，就只剩文字。最常被忽略的是主题没切、Rebuild 没运行、以及自定义配置写在了错误的位置。
