AFileIcon 插件需配合支持图标的 UI 主题（如 Adaptive、ayu）并手动启用 file_icons 开关才能显示侧边栏图标，否则即使安装成功也不生效。
Sublime Text 侧边栏默认不显示文件类型图标，AFileIcon 是目前最稳定、兼容性最好的图标增强插件，但安装后常出现图标不显示、主题冲突或重启无效等问题——核心原因是它必须与支持图标的 UI 主题（如 Adaptive、Origami 或 ayu）配合使用，且需手动启用图标开关。
确认 Sublime 已启用 Package Control 并能联网
这是所有插件安装的前提。如果 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）调不出命令面板，说明 Package Control 没装好或损坏。不要跳过这步直接搜插件：
- 访问 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1，复制对应系统的安装代码
- 在 Sublime 中打开
View → Show Console，粘贴并回车执行 - 重启 Sublime，再按
Ctrl+Shift+P输入Package Control: Install Package，看是否响应 - 若提示 “There are no packages available for installation”，大概率是代理或防火墙拦截了
packagecontrol.io域名
安装 AFileIcon 插件本身（不是主题）
AFileIcon 是一个独立插件，不是主题包，也不依赖其他插件。它只负责向侧边栏注入图标数据，实际渲染由当前 UI 主题完成：
- 按
Ctrl+Shift+P，输入Package Control: Install Package回车 - 等待列表加载完成（可能需几秒），输入
AFileIcon，选中后回车 - 安装完毕后无需重启，但图标不会立刻出现——因为默认关闭，且多数内置主题不支持图标
- 验证是否装成功：打开
Preferences → Package Settings → AFileIcon → Settings，能看到 JSON 配置文件即表示已就位
切换到支持图标的 UI 主题并开启图标开关
即使装了 AFileIcon，用默认的 Default 或 Slush & Poppies 主题也看不到图标。必须换主题 + 手动开开关：
- 先安装一个支持图标的主题，例如
Adaptive（Sublime 自带，最轻量）或ayu（需单独安装） - 按
Ctrl+Shift+P输入UI Theme，选择Set UI Theme→Adaptive.sublime-theme - 再按
Ctrl+Shift+P输入AFileIcon，运行AFileIcon: Enable Icons - 或者手动编辑用户设置：
Preferences → Settings – User，添加这一行："file_icons": true
- 注意：
"file_icons"必须是顶层键，不能嵌套在"theme"或其他对象里
常见图标不显示的三个硬性原因
90% 的“装了没反应”问题都卡在这三点，顺序检查比重装更有效：
- 当前使用的
theme不支持图标（比如还在用Default.sublime-theme），AFileIcon无法注入 DOM 节点 -
file_icons设置为false或根本没写，哪怕主题支持，开关关着也没用 - Sublime 版本太旧（goe UI Symbol），导致图标字符渲染为空白方块
- 额外提醒：某些定制主题（如
Material Theme）需额外安装Material Theme File Icons子包，和AFileIcon冲突，二者不能共存
真正起作用的是「主题支持 + 开关开启 + 插件就位」三者同时满足。很多人卡在以为装完插件就自动生效，其实 AFileIcon 只是提供图标映射表，渲染权始终在 UI 主题手里。
