AFileIcon插件为Sublime Text侧边栏文件添加图标，需配合支持图标的主题如Material Theme使用。通过Package Control安装插件和主题后，在设置中启用主题，图标即生效。若不显示，可刷新侧边栏、清除缓存或重建图标缓存。自定义图标需修改User目录下的icon_map.json并确保图标资源存在。
安装并使用 AFileIcon 插件后，Sublime Text 能为不同类型的文件显示对应的图标，提升项目浏览的直观性。这个插件通常与 AAAPackageDev 或 Material Theme 等主题配合使用效果更佳。以下是具体使用方法和技巧。
安装 AFileIcon 插件
最简单的方式是通过 Package Control 安装：
- 按下 Ctrl+Shift+P（Mac 上是 Cmd+Shift+P）打开命令面板
- 输入 Install Package 并选择对应选项
- 搜索 AFileIcon，点击安装
安装完成后无需重启，图标会自动在侧边栏中生效（前提是已启用文件图标的主题）。
确保主题支持文件图标
AFileIcon 本身只提供图标资源，实际显示依赖于 UI 主题。推荐使用以下主题之一：
- Material Theme：最常用，图标清晰，适配良好
- Seti_UI 或 Adaptive Theme：也支持文件图标显示
以 Material Theme 为例：
- 通过 Package Control 安装 Material Theme
- 进入 Preferences → Browse Packages...
- 找到 User/Preferences.sublime-settings
- 添加或修改设置：
{
"theme": "Material-Theme.sublime-theme",
"color_scheme": "Packages/Material Theme/schemes/Material-Theme.tmTheme"
}
保存后即可看到侧边栏文件带有图标。
常见问题与解决技巧
有时图标不显示或显示为默认图标，可尝试以下方法：
- 刷新侧边栏：右键侧边栏 → Refresh Folders
- 清除缓存：关闭 Sublime，删除 Data/CachedIcons 目录内容
- 检查文件关联：AFileIcon 按扩展名匹配图标，若自定义语言未识别，需在语法定义中正确设置扩展名
- 手动触发图标更新：使用命令面板运行 AFileIcon: Rebuild Icon Cache
自定义图标（进阶用法）
如果需要为特定文件类型添加或替换图标：
- 找到 AFileIcon 插件目录：Packages/AFileIcon
- 查看 icon_map.json 文件，了解图标映射规则
- 复制一份到 Packages/User/AFileIcon/icon_map.json 进行修改
- 添加新的扩展名映射，例如：
"*.myext": "file_type_custom",
然后确保对应图标名在主题资源中存在，或自行添加 SVG 图标到主题包中。
基本上就这些。AFileIcon 使用简单，关键是搭配合适的主题，并确保缓存和配置正确。不复杂但容易忽略细节。
