AFileIcon插件图标不显示的根本原因是未激活、主题不支持或缓存未重建；需确认enabled为true、选用兼容主题、开启平台开关、执行Rebuild Icons并重启。
Sublime安装AFileIcon插件后文件图标不更新，不是插件没装上，而是它根本没被激活——插件只负责挂class，主题不认、开关没开、缓存没建，三个环节断掉一个，侧边栏就永远是纯文字列表。
确认插件是否真正启用
打开Preferences → Package Settings → A File Icon → Settings – User，检查内容是否为空对象{}或明确包含"enabled": true；如果看到"enabled": false或整个配置块被注释掉，图标必然不显示。
按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入A File Icon: Enable，回车执行；若命令不存在，说明插件未正确加载，需检查ignored_packages里是否误删了"A File Icon"。
【ignored_packages中含"Default"或"Theme - Default"会直接阻止所有主题资源加载，图标class彻底失效】
切换到支持图标的主题
方法一：按Ctrl+Shift+P输入UI: Select Theme → 选AFileIcon Dark.sublime-theme或AFileIcon Light.sublime-theme（最稳，无需额外配置）。
方法二：继续用Adaptive.sublime-theme，但必须在Preferences → Settings – User顶层JSON中加一行："file_icons": true，且不能缩进、不能包在其他对象里。
别用Default、Slush & Poppies、Origami等默认主题凑合——它们压根没定义.icon-js这类CSS规则，class挂上了也渲染不出图形。
重建图标缓存
第一步：按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→ 输入A File Icon: Rebuild Icons → 回车。
第二步：观察控制台（Ctrl+`）输出，等待出现Finished rebuilding icons；若卡住或报AFileIcon: failed to inject icon classes，大概率是网络受限或ST版本低于4.4192。
第三步：完全退出Sublime Text，再重新打开——热加载可能失败，重启才能确保新缓存生效。
这一步操作起来很简单，直接运行命令就行；但跳过它，插件就只是“挂名”，SVG资源根本没下载，DOM里空有class，没有对应图标文件。
检查系统级开关是否开启
Linux用户必须在Settings – User顶层加："file_icons_linux": true；
macOS用户必须加："file_icons_osx": true；
Windows用户必须加："file_icons_win": true。
这些开关不开启，对应平台的图标注入机制就不会启动，哪怕主题和缓存都对，图标照样空白。
验证图标class是否已注入
打开任意一个.js文件，右键侧边栏该文件名 → Copy File Path，然后在命令面板中运行View Package File，输入A File Icon/side_bar.sublime-menu，能打开即说明插件资源就位。
再按Ctrl+Shift+P输入Developer: Show Scope Name，把光标悬停在侧边栏文件名上，若scope中出现icon-js或icon-folder等前缀，说明class已成功注入；若只有text.plain或meta.file，说明插件监听失败或被ignored_packages屏蔽。
