sublime text 文件图标需 a file icon 插件与支持图标的 ui 主题（如 adaptive）协同实现，单独安装“图标主题”无效；必须先装插件、再配主题、最后在用户设置顶层添加 "file_icons": true 并完全重启。
Sublime Text 没有“图标主题”这个独立概念，所谓图标显示，必须由 A File Icon 插件 + 支持图标的 UI 主题（如 Adaptive、ayu、Material Theme）协同完成，单独装“图标主题”无效。
为什么搜不到“AFileIcon Theme”或类似图标主题？
Sublime Text 不像 VS Code 那样有独立的图标主题 marketplace。所有侧边栏文件图标都来自字体（Octicons），由 A File Icon 提供映射规则和字体资源，再由 UI 主题里的 .sublime-theme 文件实际渲染。你看到的 “AFileIcon Dark.sublime-theme” 并不是图标主题，而是它附带的一个轻量 UI 主题变体——它本身不提供新图标，只调整背景/文字色以适配图标颜色。
- 在 Package Control 里搜 “icon theme”“file icon theme” 等关键词，结果基本是过时、停止维护或 ST3 兼容的废弃包（如
FileIcons、Seti_UI） -
A File Icon的作者是sublimelsp，任何其他作者（如kkga）的分支在 ST4 上图标覆盖率低、易出错 - 所谓“启用图标主题”，本质是切换到一个已内置图标支持的 UI 主题，并打开
file_icons开关
正确安装路径：先装插件，再配主题，最后开开关
必须按顺序执行，跳步或颠倒会导致图标不显示：
- 用
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）呼出命令面板 - 输入
Package Control: Install Package→ 等列表加载完 → 输入A File Icon→ 回车安装（注意空格和大小写） - 再同样方式安装 UI 主题，例如
Material Theme或直接使用 Sublime 自带的Adaptive.sublime-theme - 编辑
Preferences → Settings – User，添加两行（位置必须在顶层 JSON，不能嵌套）："theme": "Adaptive.sublime-theme",<br>"file_icons": true
- 关闭并**完全重启 Sublime Text**（不是重载窗口），否则 CSS 规则不注入，图标不会渲染
常见失效原因：主题冲突、配置错位、缓存卡住
装完重启后仍无图标，别急着重装，先查这三处：
-
ignored_packages列表里是否误加了"A File Icon"？检查Settings – User中该字段是否存在并删掉 - 用了
Material Theme却又装了A File Icon：二者图标系统互斥，Material 内置图标支持，此时应禁用A File Icon，改用它的原生配置（如"material_theme_small_file_icons": true） - 图标缓存没刷新：按
Ctrl+Shift+P输入AFileIcon: Rebuild Icon Cache执行，比重启更快见效 - Linux/macOS 用户需额外加字段：
"file_icons_linux": true或"file_icons_osx": true，否则默认不启用
冷门后缀（.env、.toml、.astro）怎么加图标？
不是重装插件，也不是找新图标包，而是手动映射扩展名到已有图标名：
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加字段
"icon_file_extensions"，键必须小写、无点、纯扩展名："icon_file_extensions": {<br> "env": "settings",<br> "toml": "config",<br> "astro": "html"<br>} - 值必须是插件内置图标名（见其 GitHub README 的
icon_map.json），拼错或不存在就 fallback 成空白文档图标，且不报错 - 改完保存，无需重启，但需运行
AFileIcon: Rebuild Icon Cache生效
真正卡住人的地方，往往不是装不上，而是以为“装了插件=图标自动出现”，忽略了主题兼容性、配置层级、重启强制性和缓存机制这四层依赖。尤其是 file_icons 必须写在用户设置顶层、布尔值不能加引号、重启不可跳过——这三个点，90% 的失败都栽在这儿。
