a file icon 无图标主因是 package control 未联网激活、主题不兼容或配置位置错误；需确认 package control 可用、安装官方 sublimelsp 版本、重启编辑器、在 settings – user 顶层启用 "file_icons": true，并选用支持图标注入的 ui 主题。
装了 A File Icon 却没图标？大概率不是插件没装好，而是 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执行
必须用 sublimelsp 版本，别装错作者
Package Control 搜索“A File Icon”时，会出现多个同名包。只有作者是 sublimelsp 的才是官方维护的正确版本；kkga 或其他作者的分支早已停止更新，图标覆盖率低、兼容性差。
- 安装前务必确认作者名：在 Package Control 列表中鼠标悬停，看右下角显示的 author 字段
- 已装错？先执行
Package Control: Remove Package卸载，再重装A File Icon（作者sublimelsp） - 装完必须重启 Sublime Text —— 不重启，图标 CSS 规则不会注入 sidebar_tree 渲染流程
图标显示依赖主题 + 配置双生效，缺一不可
A File Icon 本身不渲染图标，它只是提供图标字体和 CSS 映射规则；最终能否显示，全看 UI 主题是否支持 sidebar_tree 且启用了图标注入点。
-
"file_icons": true必须直接写在Preferences → Settings – User的顶层 JSON，不能嵌套在"theme"或其他对象里；常见错误是留着默认的"file_icons": false没删 - 默认
Adaptive.sublime-theme和Default.sublime-theme不支持图标；推荐用Material-Theme.sublime-theme、Soda Theme或Ayu - 用 Material Theme 时，还需额外加一行：
"material_theme_small_file_icons": true，否则图标可能被压缩成小方块甚至消失 - 临时验证？菜单 →
Preferences → Theme → Adaptive.sublime-theme，再运行命令AFileIcon: Rebuild Icon Cache，比重启更快
冷门后缀没图标？不是插件漏了，是你没映射
.env、.toml、.dockerignore 这类文件默认无图标，不是 bug，是插件故意留白——它只内置约 200 种高频扩展名，其余靠用户手动映射。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加类似这样的规则：
{"file_extensions": {"env": "icon_file_type_settings", "toml": "icon_file_type_config"}} - 右侧图标名（如
icon_file_type_settings）必须来自插件内置集合；瞎写会无效；查可用名可翻插件默认设置（Preferences → Package Settings → A File Icon → Settings – Default） - 改完保存，右键侧边栏 →
Refresh Folders或再运行一次AFileIcon: Rebuild Icon Cache
最容易被忽略的是：图标本质是字体 + CSS 覆盖，不是真实图片。换主题、调字号、开高 DPI 缩放时，图标可能错位或截断——这不是配置问题，是 Sublime 渲染机制限制。真要稳定，就别混搭太多定制主题和旧版插件。
