sublime text侧边栏默认不显示文件图标，因其原生ui不依赖系统图标机制，必须通过a file icon插件注入css类并配合专用主题（如afileicon dark/light）才能生效；需确保st≥4.4192、禁用ignored_packages中的default主题、重启后运行rebuild icons命令，并正确配置用户级file_extensions映射。
Sublime Text 侧边栏默认不显示文件图标，这不是插件没装好，而是它压根不支持——必须靠 AFileIcon 注入 CSS 类并绑定主题才能生效。只装插件不换主题、不重启、不重建缓存，90% 的人会卡在“没图标”这一步。
为什么装了 AFileIcon 还是没图标？
插件本身只是“调度员”，真正画图标的不是它，是主题里的 CSS 规则。常见断点：
-
ignored_packages里误加了Default或Theme - Default—— 这会让 Sublime 跳过加载原生主题资源，AFileIcon的图标 class 就找不到渲染入口 - 没切换到
AFileIcon Dark.sublime-theme或AFileIcon Light.sublime-theme—— 安装完插件后，主题仍停留在Adaptive.sublime-theme或Material-Theme.sublime-theme，图标 class 不会被识别 - 没运行
A File Icon: Rebuild Icons命令 —— 插件需要下载 SVG 图标资源并生成缓存，手动安装或更新后这步不能跳过 - ST 版本低于 4.4192 —— 旧版对动态 class 注入支持不全，图标 class 可能被忽略
怎么确认图标 class 已正确注入？
打开一个文件（比如 index.js），右键侧边栏该文件 → Inspect Element（需开启 DevTools 插件或用 ST 自带调试模式），看 DOM 中是否包含类似 icon-js、icon-folder 这样的 class。没有？说明插件监听事件失败或被禁用。
检查方式：
- 命令面板输入
A File Icon: Enable，确保状态为 enabled - 打开
Preferences → Package Settings → A File Icon → Settings，确认"enabled": true - 查看控制台（
Ctrl+`）是否有AFileIcon: failed to inject icon classes报错
自定义冷门扩展名图标怎么配？
比如你想让 .astro 文件显示 HTML 图标，不能直接改插件自带的 AFileIcon.sublime-settings（升级会被覆盖），而要改用户配置：
打开 Preferences → Package Settings → A File Icon → Settings – User，写入：
{
"file_extensions": {
"astro": "html",
"tfvars": "json",
"env.local": "ini"
}
}
注意：
- 右边值必须是插件内置图标名（
html、js、folder等），拼错就 fallback 成默认文档图标 - 改完保存，已打开的标签页不会自动刷新图标，需重新打开该文件
- 不要用通配符（如
"*"）或正则，只支持精确小写扩展名映射
和 SidebarEnhancements 共存要注意什么？
可以共存，但职责分明：SidebarEnhancements 管右键菜单和文件操作，AFileIcon 管图标渲染，两者不冲突。不过有两点容易踩坑：
- 如果同时装了
Material Theme并启用了它的图标，再开AFileIcon主题，可能因 CSS 优先级混乱导致部分图标错位或不显示——建议二选一，别混用图标主题 -
SidebarEnhancements的New File功能在某些AFileIcon主题变体下按钮文字会重叠，这是 CSS margin 冲突，临时解法是关掉AFileIcon的文件夹展开箭头："show_folder_arrows": false
最常被忽略的是 ignored_packages 和主题路径缓存——图标出不来时，先查这两处，比重装插件快十倍。
