A File Icon 无反应的主因是主题未启用其补丁。需确认安装后重启、选择 A File Icon 配套主题（如 Default 或 Adaptive），第三方主题需手动兼容；自定义后缀须在 Settings – User 中映射图标名；与 SideBarEnhancements 冲突时可禁用或设 "force_enabled": true；Linux 用户需装 fonts-dejavu 并关硬件加速。
为什么 A File Icon 插件装了但没反应？
最常见原因是插件未正确激活主题支持。A File Icon 本身不直接绘制图标，而是通过替换 Sublime Text 的 Default.sublime-theme 中的文件夹/文件节点样式来实现。如果当前使用的 UI 主题（比如 Adaptive 或 Default）没有加载 A File Icon 提供的补丁，图标就完全不会出现。
- 确认已安装
A File Icon（通过 Package Control 安装后需重启 Sublime） - 检查是否启用了配套主题：菜单栏 →
Preferences → Color Scheme → A File Icon → Default（或Adaptive） - 若用的是第三方 UI 主题（如
ayu、Material Theme），它们可能屏蔽了 A File Icon 的注入——此时需手动启用兼容模式或换回Default主题测试
如何让图标在侧边栏（Sidebar）真正显示出来？
Sublime 的侧边栏图标依赖两个关键配置：一是主题层面对 sidebar_tree 的 icon 定义，二是插件对文件扩展名的映射规则。A File Icon 默认只对常见类型（如 .js、.py、.html）提供图标，冷门或自定义后缀需要手动注册。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加自定义映射，例如让
.env显示齿轮图标：{ "file_icons": { "env": "gear" } } - 图标名必须来自 A File Icon 内置集合（
document、folder、settings、gear等），拼错或不存在会 fallback 到默认空白图标 - 修改后无需重启，但需折叠再展开侧边栏（或按
Ctrl+K Ctrl+B关闭再打开）才能刷新
A File Icon 和其他插件（如 SideBarEnhancements）冲突怎么办？
SideBarEnhancements 会重写右键菜单和部分侧边栏行为，有时会覆盖 A File Icon 注入的 CSS 规则，导致图标变回默认小方块或消失。这不是 Bug，而是两者对 sidebar_tree 节点的样式控制权竞争。
- 优先禁用
SideBarEnhancements测试：菜单栏 →Preferences → Package Control → Disable Package → SideBarEnhancements - 若必须共存，可在
A File Icon的Settings – User中强制启用高优先级样式：{ "force_enabled": true, "prefer_emoji": false } -
prefer_emoji: false很关键——开启后图标会退化为 emoji 字符，在某些字体/缩放下模糊或错位，关闭才能使用清晰的矢量图标
Mac / Windows / Linux 下图标显示不一致？
根本原因是 Sublime Text 各平台对 SVG 图标渲染的支持差异。macOS 和 Windows 原生支持较好；Linux（尤其 GTK 环境）常因字体缺失或缩放设置导致图标不显示或错位。
- Linux 用户务必确认系统已安装
fonts-font-awesome或fonts-dejavu（Ubuntu/Debian）：sudo apt install fonts-dejavu
- 所有平台都应关闭硬件加速测试：菜单栏 →
Preferences → Settings，在Settings – User中添加"hardware_acceleration": "none"
- 如果仍异常，临时切换到
Preferences → Theme → Default排查——第三方主题的icon_margin或indent设置可能挤压图标空间
