A File Icon 正常工作需同时满足:顶层布尔值 "file_icons": true、安装官方 sublimelsp 版本、启用支持图标的主题(如 AFileIcon Dark)、重启 Sublime Text 并运行 Rebuild Icons。

检查 file_icons 是否启用且位置正确
Sublime 不会从嵌套对象里读取图标开关,"file_icons": true 必须出现在用户设置(Preferences → Settings – User)的 JSON 顶层,不能包在 "theme" 或其他字段里。
常见错误包括:
- 写成字符串
"file_icons": "true"(必须是布尔值) - 拼错成
file_icon或fileIcons - 被
ignored_packages误关:如果"ignored_packages": ["Default"],A File Icon 就失去注入基础 class 的能力
确认 UI 主题是否真正支持图标渲染
插件 A File Icon 只负责加 icon-js、icon-folder 这类 class,不提供任何图形。图形由当前启用的 .sublime-theme 文件绘制。
默认的 Adaptive.sublime-theme 和 Default Dark.sublime-theme 都不含图标规则,所以即使插件装对、开关开了,侧边栏也空白。
可行方案:
- 切换到
AFileIcon Dark.sublime-theme或AFileIcon Light.sublime-theme(专为图标设计) - 用
Material-Theme.sublime-theme,但需额外配"material_theme_small_file_icons": true - 别指望
ayu或Soda自动兼容新扩展名——它们常漏掉.astro、.svelte等 class 映射
验证插件是否装对、路径是否匹配
Package Control 搜索 A File Icon 会列出多个同名包,只有作者是 sublimelsp 的那个才完整支持 ST4+。kkga、braver 等分支在 2026 年已停止维护,图标规则缺失严重。
安装后必须重启 Sublime Text —— .sublime-theme 文件只在启动时加载,不重启图标区域永远留白或显示问号。
手动验证方式:
- 按
Ctrl+Shift+P输入A File Icon: Rebuild Icons,看控制台是否有进度提示 - 若报
AFileIcon: failed to inject icon classes,大概率是插件版本低于 v3.0(ST4 要求)或网络受限导致 SVG 缓存未下载 - 临时删掉
Packages/User/AFileIcon/下所有文件再重建,排除缓存污染
自定义扩展名图标映射没生效?别改插件目录
想让 .astro 显示 HTML 图标、.ts 显示 JS 图标,不能去改插件自带的 AFileIcon.sublime-settings —— 更新插件时会被覆盖。
正确做法是打开 Preferences → Package Settings → A File Icon → Settings – User,填入:
{
"file_extensions": {
"astro": "html",
"ts": "javascript"
}
}
注意:
- 扩展名不带点(
"astro",不是".astro") - 右侧值必须是插件已内置的图标类型名(
"html"、"javascript"、"json"),拼错就 fallback 成文档图标 - 保存后需重新运行
A File Icon: Rebuild Icons才能生效
最容易被忽略的是:图标主题和 UI 主题是两套独立系统,改了 color_scheme 不影响图标,改了 file_icons 也不代表图标能画出来——缺了任一环,侧边栏就只剩文字。











