a file icon 无图标需同时满足三条件：sublime text 版本≥4.4192、ui主题支持图标（如material-theme/ayu）、用户设置顶层配置"file_icons": true；缺一即仅显示文字。
装了 A File Icon 却没图标？不是插件没装上，而是三个硬条件没同时满足：Sublime Text 版本 ≥ 4.4192、UI 主题支持图标注入、用户设置里顶层写了 "file_icons": true。少一个，侧边栏就只有文字，没有图标。
怎么确认 Package Control 能正常联网拉包
很多用户卡在“点了 Package Control: Install Package 没反应”或提示 There are no packages available——这根本不是 A File Icon 的问题，是 Package Control 压根没活过来。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）必须能呼出命令面板；呼不出说明Package Control没安装或被杀软/防火墙拦截 - 输入
Package Control: Install Package后空白/卡住 → 检查公司代理、packagecontrol.io是否被屏蔽、杀毒软件是否阻止网络请求 -
Preferences → Package Settings里没有Package Control项 → 去packagecontrol.io复制对应系统的安装代码，粘贴进View → Show Console执行
为什么装对了还是没图标：主题 + 配置双失效点
A File Icon 本身不画图，它只提供图标字体和 CSS 映射规则；真正决定图标显不显示的，是当前 UI 主题里有没有预留图标占位区、有没有加载这些规则。
-
Default.sublime-theme和Adaptive.sublime-theme默认不支持图标（留白或问号），必须换用Material-Theme.sublime-theme、ayu或Theme - Soda -
"file_icons": true必须直接写在Preferences → Settings – User的 JSON 顶层，不能嵌套在"theme"或其他对象里；写成"file_icons": "true"（字符串）或"file_icon": true（拼错键名）都无效 - 用
Material Theme还得额外加一行："material_theme_small_file_icons": true，否则图标可能被压成小方块甚至消失
冷门后缀没图标？别重装插件，改配置就行
.env、.toml、.tfvars、.astro 这类扩展名默认不绑定图标，不是插件漏了，是设计上留给用户自定义的。
- 路径：
Preferences → Package Settings → A File Icon → Settings – User - 添加字段，例如：
"icon_file_extensions": {"env": "settings", "toml": "config"} - 注意：映射值（如
"settings"）必须是A File Icon自带的图标名，可在插件目录下的icon_map.json里查到 - 如果想让某个后缀走语法 scope 匹配（比如
.astro文件实际是 HTML 类型），就得去对应语法包里确认scope是否正确，否则扩展名映射也无效
最容易被忽略的是版本兼容性：低于 4.4192 的 Sublime Text 会静默禁用图标逻辑——不报错、不提示、也不渲染，只留白。检查方式很简单：Help → About Sublime Text 看右下角版本号。升级后必须重启，否则插件加载链不会触发。
