A File Icon 插件需同时满足三个条件才能显示图标：启用支持图标的主题、在用户设置顶层启用"file_icons": true、Package Control能联网；还需按系统添加对应开关并手动重建图标缓存。
A File Icon 插件本身不显示图标，它只负责把扩展名映射成 CSS class；真正决定图标长什么样的，是当前启用的 UI 主题 —— 换句话说，装上插件 ≠ 看到图标，主题不匹配或没启用，图标就永远是空白。
为什么装完 A File Icon 侧边栏还是没图标？
这不是插件没装好，而是三个条件没同时满足：
- 当前
theme必须是支持图标的主题（如Adaptive.sublime-theme、Material-Theme.sublime-theme，而Default.sublime-theme和Slush & Poppies不支持） -
"file_icons": true必须直接写在Preferences → Settings – User的顶层 JSON 中，不能嵌套在"theme"或其他对象里 - Package Control 必须能联网访问
packagecontrol.io—— 如果命令面板里搜Package Control: Install Package显示 “no packages available”，大概率是网络被拦截
验证方式：打开控制台（View → Show Console），执行 import urllib.request; print(urllib.request.urlopen('https://packagecontrol.io').getcode())，返回 200 才算通。
如何让 .env、.toml、.astro 这类后缀显示图标？
插件默认不识别这些扩展名，但支持手动映射，格式极其严格：
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加字段：
"file_extensions": {"env": "settings", "toml": "config", "astro": "html"} - 左侧键名必须小写、无点、纯扩展名（
"env"✅，".env"❌，"ENV"❌） - 右侧值必须是插件内置图标名（查
Packages/AFileIcon/icons/下的文件名，如settings.svg、config.svg） - 拼错或图标名不存在，会 fallback 成空白文档图标，且不报错、不提示
Linux/macOS/Windows 各自要加什么配置？
不同系统需显式开启对应开关，否则图标可能不加载：
- Linux 用户必须在
Settings – User中加："file_icons_linux": true - macOS 用户必须加：
"file_icons_osx": true - Windows 用户必须加：
"file_icons_win": true - 如果用了 Soda 或 Flatland 这类老主题，还得额外加：
"file_icons_soda": true或"file_icons_flatland": true
这些配置都得写在顶层，和 "file_icons": true 并列，不能缩进或包在别的 object 里。
图标缓存不刷新，改了设置也没用怎么办？
插件不会自动监听配置变化，必须手动重建缓存：
- 用命令面板（
Ctrl+Shift+P/Cmd+Shift+P）运行：AFileIcon: Rebuild Icon Cache - 比重启更快生效，尤其适合调试自定义映射时反复验证
- 如果图标错位、重复或显示异常，先运行
AFileIcon: Purge Icon Cache清空旧缓存，再重建 - 注意：某些 ST4 版本（如 macOS 上的 4.42xx）即使运行了重建命令，也必须重启才能加载新图标
最常被忽略的是「系统专属开关」和「缓存重建」这两步 —— 尤其在 Linux 或 macOS 上，漏掉 file_icons_osx 或 file_icons_linux，图标就永远出不来，连错误提示都没有。
