afileicon无图标是因css类注入、主题支持和用户启用三者缺一不可；需确认package control联网正常，安装后运行rebuild icons，切换至afileicon dark/light等支持主题，并在settings–user顶层设"file_icons": true。
装了 AFileIcon 却没图标？不是插件坏了，是 Sublime Text 4 的图标机制根本没被触发——它不靠插件“画图”，而是靠插件注入 icon-js 这类 CSS class + 主题识别 class + 用户显式开启 "file_icons": true 三者协同生效。漏掉任意一环，侧边栏就永远是纯文字。
确认 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，可临时关防火墙测试
安装后必须运行 A File Icon: 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"映射，例如：{ "file_extensions": { "astro": "html", "toml": "config", "env": "ignore" } } - 保存后无需重启，但需再次运行
A File Icon: Rebuild Icons才能生效
最容易被忽略的是：每次更新 AFileIcon 或切换主题后，A File Icon: Rebuild Icons 都得重跑一遍；"file_icons": true 必须在用户设置顶层，嵌套在 "theme" 里等于白写；ignored_packages 里藏一个 "Default" 就能让整个图标链路静默失效。
