图标不显示需同时满足file_icons开关开启、使用支持图标的UI主题、清除缓存三条件；配置须置于Settings–User顶层，布尔值正确，排除project覆盖与ignored_packages干扰，并手动重建图标。
图标不显示不是插件没装，而是 file_icons 开关、UI 主题、缓存三者没对齐——缺一不可。
检查 file_icons 是否在用户设置顶层生效
这个配置必须直接写在 Preferences → Settings – User 的 JSON 最外层，不能嵌套在 "theme" 或其他对象里。
-
"file_icons": true必须是布尔值，写成"file_icons": "true"或"file_icon": true都无效 - 如果用了
.sublime-project文件，它可能覆盖全局设置，临时删掉或注释掉其中的"file_icons"和"theme"字段验证 - 确认
ignored_packages没禁用"Default"或"Theme - Default"—— 这会导致主题资源加载失败，图标 class 无处渲染
确认当前主题是否真正支持图标规则
默认的 Default.sublime-theme 和 Adaptive.sublime-theme（哪怕名字带 “Adaptive”）都不含 icon_file_type 或 icon_folder 规则，图标必然空白。
- 必须切换到明确支持图标的主题：比如
AFileIcon Dark.sublime-theme、Material-Theme.sublime-theme、ayu-dark.sublime-theme - 部分主题需额外启用开关：Material Theme 要加
"material_theme_small_file_icons": true，AYU 要确保没禁用"file_icons": true（它可能藏在 theme 自带 settings 里） - 别信“兼容”宣传——很多第三方主题漏掉了
icon-astro、icon-svelte等新扩展名映射，导致对应文件仍无图标
运行 A File Icon: Rebuild Icons 并验证 Sublime 版本
插件安装或升级后，SVG 图标资源不会自动下载；且 ST
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入A File Icon: Rebuild Icons并回车 - 看控制台（
Ctrl+`）是否有进度提示；若卡住或报AFileIcon: failed to inject icon classes，大概率是网络受限或 ST 版本过低 - 菜单栏 →
Help → About Sublime Text，右下角版本号必须 ≥4.4192；低于此版本必须升级官网最新安装包并重启 - 重建后仍无图标？临时删掉
Packages/User/AFileIcon/下所有缓存文件再试
冷门扩展名（如 .env、.toml、.astro）需要手动映射
这些后缀不在默认映射表里，不是插件漏了，是设计上留给用户自定义的——但映射目标必须是插件内置的图标标识符，拼错就 fallback 成空白文档图标。
- 路径：
Preferences → Package Settings → A File Icon → Settings – User - 添加字段，例如：
{"file_extensions": {"env": "settings", "toml": "config", "astro": "html"}} -
env是扩展名（不含点），settings是插件已支持的图标类型名；写成"env": "dot-env"就无效 - 保存后需重新运行
A File Icon: Rebuild Icons才能生效，无需重启编辑器
最容易被忽略的是 ignored_packages 误禁主题，以及 file_icons 写在了嵌套 JSON 里——这两处不排查，换十次主题也没用。
