图标不显示需同时满足三要素：Package Control正常联网并安装官方A File Icon插件；当前UI主题支持图标渲染（如Default、Adaptive）；"file_icons": true置于Settings–User顶层JSON。
图标不显示？先确认 Package Control 能否联网
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）必须能弹出命令面板；弹不出，说明 Package Control 根本没装好或被拦截。输入 Package Control: Install Package 后空白/卡住 → 检查公司代理、杀毒软件是否屏蔽了 packagecontrol.io。Preferences → Package Settings 里没有 Package Control 项 → 去官网复制对应系统安装代码，粘贴进 View → Show Console 执行。
装 A File Icon 插件但没图标？三要素缺一不可
A File Icon 不靠“启用”按钮生效，它依赖 Sublime 重载 .sublime-theme 文件注入 CSS 规则。不重启，侧边栏永远只显示文字或问号。必须同时满足：
-
Package Control正常联网并成功安装插件（作者必须是sublimelsp，kkga等分支已停更、图标覆盖率低、ST4 兼容差） - 当前 UI 主题支持图标渲染（
Default.sublime-theme和Adaptive.sublime-theme默认支持；Material-Theme.sublime-theme、ayu需额外配置） -
"file_icons": true必须写在Preferences → Settings – User的顶层 JSON，不能嵌套在"theme"或其他对象里；写成"file_icons": "true"（字符串）或"file_icon": true（键名拼错）都无效
用 Material Theme 却没图标？别和 A File Icon 同时开
Material Theme 自带原生图标支持，和 A File Icon 是互斥关系——同时启用可能冲突导致图标错位或消失。若选 Material Theme：
- 不要安装
A File Icon - 确保用户设置中含：
"file_icons": true和"material_theme_small_file_icons": true（否则图标可能被压成小方块甚至不显示） - 主题激活方式：按
Ctrl+Shift+P输入Material Theme: Activate theme并执行
若不确定，临时切回 Adaptive.sublime-theme 验证：菜单 → Preferences → Theme → Adaptive.sublime-theme，再运行 AFileIcon: Rebuild Icon Cache。
冷门后缀如 .env、.toml 没图标？手动映射即可
这类扩展名默认不绑定图标，不是插件漏装，而是设计上留给用户自定义。路径：Preferences → Package Settings → A File Icon → Settings – User，添加字段：
"icon_file_extensions": {
"env": "settings",
"toml": "config",
"tfvars": "config",
"astro": "html"
}
注意：左侧键名必须小写、无点、纯扩展名（"env" ✅，".env" ❌，"ENV" ❌）；右侧值必须是插件内置图标名（如 "settings"、"config"、"html"），拼错就 fallback 成空白文档图标，且不报错。
真正难的不是装插件，是搞清图标由谁渲染：A File Icon 只提供数据和字体，UI 主题才负责画图。很多人反复重装插件，却忘了检查主题是否支持、配置是否在顶层、重启是否到位——这三个点卡住，装十遍也没用。
