图标不显示是因为主题、配置、缓存三者未对齐：需切换至支持图标的主题（如AFileIcon Dark或Material-Theme）、确保Settings–User顶层含布尔值"file_icons": true、执行Rebuild Icons并重启Sublime Text。
图标不显示，不是插件没装，而是主题、配置、缓存三者没对齐——缺一不可。
确认当前 theme 是否真正支持图标渲染
A File Icon 插件只往 DOM 注入 icon-js、icon-folder 这类 class，不负责画图；真正决定“有没有图标”的是 .sublime-theme 文件里是否定义了对应 CSS 规则。
- 默认的
Default.sublime-theme和Adaptive.sublime-theme（哪怕名字带 “Adaptive”）都不含图标规则，图标区必然空白或显示问号 - 必须手动切换到明确支持的主题：如
AFileIcon Dark.sublime-theme、AFileIcon Light.sublime-theme、Material-Theme.sublime-theme或ayu-dark.sublime-theme - 别信第三方主题“兼容图标”的宣传——很多漏掉
icon-astro、icon-svelte等新扩展名的映射，检查方式是打开主题源码，搜icon-file-type-或icon_folder
检查 Settings – User 里 file_icons 是否在顶层且为布尔值
这个开关必须出现在 Preferences → Settings – User 的 JSON 最外层，拼错、嵌套、写成字符串都会失效。
- ✅ 正确写法：
"file_icons": true（单独一行，和其他配置平级） - ❌ 错误写法：
"file_icons": "true"、"file_icon": true、{"theme": {"file_icons": true}} - 如果用了
Material Theme，还需额外加："material_theme_small_file_icons": true - 检查
ignored_packages是否误加了"Default"或"Theme - Default"——这会跳过原生主题资源加载，图标 class 失去渲染入口
运行 A File Icon: Rebuild Icons 并确认 Sublime 版本 ≥ 4.4192
插件安装或升级后，SVG 图标资源不会自动下载；不执行重建命令，class 虽挂上，但对应 SVG 文件根本不存在。
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入A File Icon: Rebuild Icons回车 - 看控制台（
Ctrl+`）是否有进度提示；若卡住或报AFileIcon: failed to inject icon classes，大概率是网络受限或 ST 版本低于 4.4192 - 检查版本：菜单栏
Help → About Sublime Text，右下角数字必须 ≥4.4192；旧版静默失效，不报错也不提示 - 重建后必须重启 Sublime Text ——
.sublime-theme只在启动时加载，不重启图标区域永远留白
自定义扩展名图标要改 Settings – User，不是插件自带配置
想让 .env 显示锁图标、.astro 显示 HTML 图标，不能动插件目录下的 AFileIcon.sublime-settings，否则下次更新就被覆盖。
- 路径：
Preferences → Package Settings → A File Icon → Settings – User - 加入映射块，例如：
{"file_extensions": {"env": "lock", "astro": "html"}} - 注意：
env是扩展名（不含点），lock和html必须是 A File Icon 内置的图标标识符（拼错就 fallback 成默认文档图标） - 保存后需重新运行
A File Icon: Rebuild Icons才生效，无需重启
最容易被忽略的是：主题切换后没重启、file_icons 写在了 theme 对象里、以及 ignored_packages 误禁了原生主题——这三项出问题，其他全配对也白搭。
