图标不显示需同时满足三点：UI主题支持图标渲染（如Adaptive或ayu）、用户设置中顶层含"file_icons": true、Package Control能联网访问packagecontrol.io。
图标不显示？先看这三件事有没有做对
Sublime 本身不带文件图标，A File Icon 只是“注入图标数据”的插件，不是装上就亮的开关。90% 的失败都卡在以下三点没同时满足：
- 当前 UI 主题必须支持图标渲染（
Default.sublime-theme和Slush & Poppies默认不支持） -
"file_icons": true必须出现在Preferences → Settings – User的顶层 JSON 中，不能包在"theme"或其他对象里 - Package Control 必须能联网加载列表——如果命令面板里输
Package Control: Install Package提示 “no packages available”，大概率是被公司网络、杀毒软件或系统代理屏蔽了packagecontrol.io
别急着重装插件，先按这个顺序检查：打开 Preferences → Package Settings，看有没有 A File Icon 项；再确认主题是不是 Adaptive.sublime-theme 或 ayu；最后打开控制台（View → Show Console），手动执行 import urllib.request; print(urllib.request.urlopen('https://packagecontrol.io').getcode()) 看是否返回 200。
安装 A File Icon 插件的正确姿势
它不是主题，也不是图标资源包，而是一个“绑定扩展名到图标 class”的逻辑层。安装错方式会导致后续所有配置失效。
- 必须用 Package Control 安装：
Ctrl+Shift+P→ 输入Package Control: Install Package→ 等几秒列表加载完 → 搜A File Icon→ 回车 - 不要手动下载 zip 解压进
Packages/目录，这样插件无法注册事件监听，图标 class 不会注入 sidebar DOM - 安装后需重启 Sublime（ST4.4192+ 才完全兼容，低于此版本会静默失效）
- 验证是否装成功：打开
Preferences → Package Settings → A File Icon → Settings，能打开 JSON 文件即表示已就位
注意：A File Icon 不提供配色方案，也不改编辑区颜色——它只管侧边栏里 .js、.py 这些文件名左边的小图标。
让 .env、.toml 这类冷门后缀也显示图标
插件内置约 200 种扩展名映射（如 .js→js，.md→markdown），但像 .env、.tfvars、.astro 默认不识别。这不是 bug，是设计使然——得手动告诉它“这个后缀该用哪个图标”。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加字段：
"file_extensions": {"env": "settings", "toml": "config", "astro": "html"} - 图标名必须来自插件内置集合（见
Packages/AFileIcon/icons/下的文件名，如settings.svg、config.svg），拼错就 fallback 成空白文档图标 - 改完保存，已打开的文件不会实时更新图标，需关闭再重开该文件，或右键侧边栏 →
Refresh Folders
别去改插件自带的 AFileIcon.sublime-settings，升级时会被覆盖。
图标颜色、大小和缓存问题怎么调
图标本质是字体（Octicons）+ CSS class + 主题渲染，所以调整不靠换图，而靠改样式或清缓存。
- 图标颜色由当前 UI 主题的 CSS 控制，可用
Customize Theme插件微调，例如加规则："rules": [{"class": "icon_file", "color": "var(--green)"}] - 图标大小无法全局缩放，但部分主题（如
Material Theme）提供"material_theme_small_tab_font": true类似开关间接影响视觉比例 - 缓存卡住很常见：关闭 Sublime，删掉
Cache/A File Icon/目录（路径可通过Preferences → Browse Packages…进入Packages后向上一级找Cache） - 重建缓存命令：
Ctrl+Shift+P→A File Icon: Rebuild Icon Cache，比重启更轻量
最常被忽略的是：改了用户设置后没关重新开文件，或者用了 Soda 这类老主题却没加 "file_icons_soda": true——图标渲染链断一环，整条就黑屏。
