图标不显示是因为a file icon插件仅注入icon-js等css类，而图标渲染依赖ui主题支持；必须切换至afileicon dark/light主题、运行rebuild icons命令、确保file_icons:true且ignored_packages未禁用default主题。
图标不显示不是主题坏了，是 A File Icon 插件和当前 UI 主题没对上——插件只加 icon-js 这类 class，真正画图的是主题里的 CSS 规则。用 Adaptive、Material 或 Ayu 等第三方主题时，常因缺少 class 映射或开关未开导致空白。
确认 file_icons 是否写在设置顶层
这个配置必须出现在 Preferences → Settings – User 的 JSON 最外层，不能嵌套在 "theme" 或其他对象里：
-
"file_icons": true是唯一有效写法；"file_icon"、"file_icons_enabled"、"theme": {"file_icons": true}全部无效 - 拼错一个字母或加了多余逗号，Sublime 会静默忽略整段 JSON
- 改完保存后需重启 Sublime Text 才能加载新设置（缓存不刷新）
检查 ignored_packages 是否禁用了关键主题
如果 "ignored_packages" 列表里有 "Default" 或 "Theme - Default"，Sublime 会跳过加载原生主题资源，导致所有图标 class 失去渲染入口：
- 打开
Preferences → Settings – User，搜索ignored_packages - 确认值为
[]，或至少不含"Default"、"Theme - Default"、"A File Icon" - 哪怕只是临时测试，也别留着
"A File Icon"在里面——它会被彻底禁用
换主题前先停用冲突的第三方主题
Material Theme、AYU、Seti_UI 等虽标榜“支持图标”，但实际常漏掉 icon-astro、icon-svelte 等新扩展名映射，且部分需额外开关：
- 优先切换到
AFileIcon Dark.sublime-theme或AFileIcon Light.sublime-theme—— 它们由插件作者维护，class 覆盖最全 - 若坚持用 Material Theme，必须在用户设置中加：
"material_theme_icons_tree_view": true - AYU 用户要确认没在 theme 自带 settings 里把
"file_icons": false写死 - 别用
Default.sublime-theme或Slush & Poppies.sublime-theme—— 它们压根没定义icon_folder规则
重建图标缓存并验证 Sublime 版本
A File Icon 在低于 4.4192 的版本中会静默失效，不报错也不提示；重建缓存则确保 SVG 资源已下载并注入 DOM：
- 菜单栏 →
Help → About Sublime Text，右下角看版本号；低于4.4192必须升级 - 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入A File Icon: Rebuild Icons并回车 - 观察控制台（
Ctrl+`）是否有进度输出；若卡住或报AFileIcon: failed to inject icon classes，大概率是网络受限或版本太低 - 重建后仍无图标？删掉
Packages/User/AFileIcon/下全部文件再试一次
最容易被忽略的是：改了 Settings – User 里的 file_extensions 映射后，不运行 A File Icon: Rebuild Icons，图标就不会更新——它不会热重载 SVG 缓存。
