afileicon没图标是因css类注入、主题支持和用户启用三者缺一不可；需确认package control联网正常，安装后运行rebuild icons，切换至afileicon dark/light等支持主题，并在settings–user顶层设"file_icons": true。
装了 AFileIcon 却没图标？不是插件坏了，是 Sublime Text 4 的图标机制根本没被触发——它不靠插件“画图”，而是靠插件注入 CSS class + 主题识别 class + 用户显式开启三者协同生效。漏掉任意一环，侧边栏就永远是纯文字。
确认 Package Control 能联网拉包
这是所有后续操作的前提。如果 Ctrl+Shift+P 打不开命令面板，或输入 Package Control: Install Package 后空白/报错 There are no packages available，说明 Package Control 没真正就位。
- 打开
View → Show Console，粘贴官方安装代码执行（别跳过） - 重启 Sublime，再试
Ctrl+Shift+P → Package Control: Install Package，必须看到包列表滚动加载 - 公司网络、杀毒软件、代理常会屏蔽
packagecontrol.io，可临时关防火墙测试
安装 AFileIcon 后必须运行 Rebuild Icons
插件安装完不会自动下载 SVG 资源、也不会生成缓存映射。不手动触发，icon-js、icon-folder 这类 class 根本不会注入到侧边栏 DOM 中。
- 按
Ctrl+Shift+P，输入A File Icon: Rebuild Icons并回车 - 等待控制台输出
Finished rebuilding icons（通常几秒） - 执行后建议完全退出 Sublime 再重开，避免主题资源未热加载
- 若失败，检查控制台是否有
AFileIcon: failed to inject icon classes
主题必须支持且已启用图标渲染
AFileIcon 不提供主题，只提供 class 名。Default、Slush & Poppies、Adaptive（默认）等主题默认不定义 .icon-js 样式，所以即使 class 注入成功，也看不到任何变化。
- 按
Ctrl+Shift+P输入UI: Select Theme，选AFileIcon Dark.sublime-theme或AFileIcon Light.sublime-theme（最稳） - 或者用
Adaptive.sublime-theme，但必须在Preferences → Settings – User顶层加："file_icons": true - 检查
ignored_packages是否误含"Default"或"Theme - Default"——这会让主题资源加载中断，图标 class 失效 - Material Theme 用户需额外加：
"material_theme_big_fileicons": true，否则高分屏图标模糊
自定义冷门扩展名要映射内置图标名
.astro、.toml、.env 这些文件没图标，不是插件漏了，是你没告诉它该用哪个 icon class。AFileIcon 不允许随意写新图标名，只能复用它内置的集合（如 html、config、ignore）。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加类似这样的结构：
{ "file_extensions": { "astro": "html", "toml": "config", "dockerignore": "ignore" } } - 保存后无需重启，但建议再运行一次
A File Icon: Rebuild Icon Cache - 图标名拼错（比如写成
htm或toml-icon）会 fallback 成默认文档图标，不报错也不提示
最容易被忽略的是：图标 class 是否真被注入了。右键侧边栏任意文件 → Inspect Element（需开启 DevTools 或用 ST 自带调试），看 DOM 里有没有 icon-js 这类 class。没有，说明前面所有步骤都白做了——得回头查 Package Control、Rebuild、主题、ignored_packages 四个环节。不是版本问题，就是配置断点卡在某一层。
