a file icon 不显示图标需同时满足三个条件：sublime text 版本 ≥ 4.4192、ui 主题支持图标（如 adaptive）、用户设置顶层含 "file_icons": true；此外还需按系统启用对应开关，并正确映射冷门后缀。
装了 A File Icon 却没图标？不是插件坏了，是三个硬性条件缺一不可：Sublime Text 版本 ≥ 4.4192、当前 UI 主题支持图标渲染、用户设置顶层必须有 "file_icons": true。少一个，侧边栏就只显示文字。
确认 Sublime Text 版本是否达标
A File Icon 在低于 4.4192 的版本中会静默失效——不报错、不提示、也不显示图标。这不是配置问题，是兼容性切断。
- 检查方式：菜单栏 → Help → About Sublime Text，看右下角版本号
- 若显示
4.4191或更低，必须升级；官网下载最新 ST4 安装包覆盖安装即可 - 升级后务必重启编辑器，否则插件加载逻辑不触发
主题必须支持图标，且不能是 Default 或 Slush & Poppies
Default.sublime-theme 和 Slush & Poppies.sublime-theme 根本不预留图标占位区，装了 A File Icon 也只会留白或显示问号。
- 推荐直接用 Sublime 自带的
Adaptive.sublime-theme（最轻量、最稳） - 或第三方主题如
Material-Theme.sublime-theme、Ayu.sublime-theme - 切换方法：Ctrl+Shift+P → 输入
UI: Select Theme→ 选带.sublime-theme后缀的项 - 部分主题需额外开关，例如 Material Theme 要在
Preferences → Settings – User中加："material_theme_small_file_icons": true
用户设置里 "file_icons": true 必须写在顶层
这个配置项必须出现在 Preferences → Settings – User 的 JSON 顶层，不能嵌套在 "theme" 或其他对象里，拼写也不能错（比如写成 "file_icon" 或 "file_icons_enabled" 就无效）。
正确写法示例：
{
"theme": "Adaptive.sublime-theme",
"file_icons": true
}
- 改完保存，不用重启，但已打开的侧边栏需手动刷新：右键侧边栏 →
Refresh Folders - 如果之前装过其他图标插件或改过
ignored_packages，务必检查Settings – User里没有"ignored_packages": ["A File Icon"]这行
冷门后缀（如 .env、.toml、.astro）需要手动映射
这些扩展名默认不绑定图标，不是插件漏了，是设计上留给用户自定义的。别换插件，直接映射最快。
- 路径：
Preferences → Package Settings → A File Icon → Settings – User - 添加字段，例如：
"icon_file_extensions": {"env": "settings", "toml": "config", "astro": "html"} - 左侧键名必须小写、无点、纯扩展名（
"env"✅，".env"❌，"ENV"❌） - 右侧值必须是插件内置图标名，可查
Packages/A File Icon/icons/下的文件名（如settings.svg、config.svg），拼错或图标名不存在会 fallback 成空白文档图标，且不报错、不提示
最容易被忽略的是系统级开关：Linux 用户必须加 "file_icons_linux": true，macOS 加 "file_icons_osx": true，Windows 加 "file_icons_win": true —— 这些都得和 "file_icons": true 并列写在顶层，缺一个，对应系统图标就不加载。
