a file icon图标不显示需同时满足三条件：插件未被ignored_packages禁用、启用支持图标的主题（如adaptive或material-theme）、用户设置顶层写"file_icons": true；冷门后缀需在settings–user中配置icon_file_extensions映射，文件夹图标需单独开启colored_folders。
Sublime Text 侧边栏文件图标不是“装个插件就自动全有”，而是需要插件、主题、配置三者对齐才能生效；默认不显示 .env、.toml 等冷门后缀图标是正常行为，不是插件故障。
为什么装了 A File Icon 还没图标？检查这三件事
图标不出现，90% 是因为缺一环：插件没启用、主题不支持、或顶层配置漏了 file_icons。必须同时满足：
-
A File Icon已安装且未被加入ignored_packages（检查Preferences → Settings – User中是否含"ignored_packages": ["A File Icon"]） - 当前启用的主题明确支持图标渲染，比如
Adaptive.sublime-theme（ST4 自带）、Material-Theme.sublime-theme或ayu-dark.sublime-theme；Default.sublime-theme和老版Soda默认不支持 -
Preferences → Settings – User顶层直接写"file_icons": true——注意不能嵌套在theme或其他对象里，也不能拼成file_icon或file_icons_enabled
验证方法：临时切回 Adaptive.sublime-theme，再运行命令 AFileIcon: Rebuild Icon Cache，比重启更快见效。
如何让 .env、.toml、.astro 这类文件也显示图标
这些扩展名不在 A File Icon 默认映射表里，但不用换插件，手动加一条规则就行。关键是格式严格：
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加
"icon_file_extensions"对象，键名必须小写、无点、纯扩展名（如"env"，不是".env"或"ENV"） - 值必须是插件内置的图标名，比如
"settings"、"config"、"html"——可查Packages/A File Icon/icons/目录下的文件名（不含后缀）
示例配置：
{
"icon_file_extensions": {
"env": "settings",
"toml": "config",
"astro": "html"
}
}
填错图标名不会报错，只会 fallback 成空白文档图标，所以别猜，查源目录最稳。
文件夹图标怎么开？colored_folders 不是默认开启的
A File Icon 默认只处理文件，文件夹图标是独立开关。如果你看到文件有图标但文件夹还是小三角，就是这个没开：
- 在用户设置中加
"colored_folders": true - 顺手关掉动画避免错位：
"folder_animation": false - 某些主题（如 Material Theme）和 A File Icon 冲突，不能共存；若已启用 Material Theme，就别装 A File Icon，直接用它的原生图标支持
Linux 用户还要额外确认 "file_icons_linux": true 已写入设置；macOS 用户同理加 "file_icons_osx": true。
图标错位、颜色发灰、或只显示一半？多半是主题和字号不匹配
图标本质是字体（Octicons），靠 CSS class 注入渲染，因此高度依赖主题的排版规则：
- 禁用
"draw_white_icons": true（会导致所有图标变灰） - 如果用了高 DPI 屏幕或自定义了
font_size，尝试把字号设为整数（如12或14），避免小数导致图标截断 - Material Theme 用户必须加
"file_icons_material_theme": true，否则图标位置偏移 - 图标仅显示于侧边栏，不影响标签页或系统图标——这点常被误以为“没生效”
真正容易被忽略的是：图标不是图片资源，不能直接塞 PNG 路径；所有定制都基于字体 + class + 主题 CSS 的链式协作，任意一环断掉，就只剩空白。
