A File Icon 插件生效需同时满足三个条件：Sublime Text 版本≥4.4192、UI主题支持图标（如Adaptive/Material/Ayu）、用户设置中顶层配置"file_icons": true；缺一不可。
A File Icon 插件不是“开关一开图标就出”，它依赖三个硬性条件同时满足：Sublime Text 版本 ≥ 4.4192、当前 UI 主题支持图标渲染、用户设置中明确启用图标开关。缺一个，侧边栏就只显示文字，不显示任何图标。
确认 Sublime Text 版本是否达标
A File Icon 在低于 4.4192 的版本中会静默失效——不报错、不提示、也不显示图标。这不是插件坏了，是兼容性切断。
检查方式：菜单栏 → Help → About Sublime Text，看右下角版本号
- 若显示 4.4191 或更低，必须升级；官网下载最新 ST4 安装包覆盖安装即可
- 升级后无需卸载旧插件，但必须重启编辑器，否则插件加载逻辑不触发
主题必须支持图标，且不能是 Default/Slush & Poppies
Sublime 原生的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、.tfvars、.astro 这类扩展名默认不绑定图标，不是插件漏了，是设计上留给用户自定义的。
操作路径：Preferences → Package Settings → A File Icon → Settings – User
添加字段，例如：
"file_extensions": {
"env": "settings",
"toml": "config",
"astro": "html"
}
- 右值（如 settings）必须来自插件内置图标名，可查 Packages/AFileIcon/icons/ 目录下的 SVG 文件名（不含后缀）
- 写错就 fallback 成空白文档图标，不会报错，所以建议先试一个确定存在的名（如 js、html）
- 修改后，当前已打开的文件标签页需关闭重开，侧边栏才更新图标
真正卡住人的地方，往往不是插件本身，而是版本、主题、设置这三者没对齐。尤其是 file_icons 开关写在错误层级，或者用了不支持图标的主题还反复重装插件——这种组合问题，比代码 bug 更难直觉定位。
