图标不显示需同时启用theme和file_icons：确保theme支持图标渲染（如Material-Theme.sublime-theme）、file_icons设为true且位于用户设置顶层，修改后必须重启Sublime Text。
图标不显示？先确认 theme 和 file_icons 是否同时启用
装了 A File Icon 却没图标，大概率不是插件没装好，而是两个关键条件没凑齐：theme 指向的 UI 主题不支持图标渲染，或 file_icons 没在用户设置顶层开启。
常见错误现象：
-
"theme": "Default.sublime-theme"或"theme": "Adaptive.sublime-theme"—— 这俩默认禁用图标 -
"file_icons": true被写在"view_settings"或"theme_settings"里 —— Sublime 直接忽略 -
"ignored_packages": ["A File Icon"]还留在设置中 —— 插件被静默禁用
正确做法：打开 Preferences → Settings – User，确保 JSON 是扁平结构，只含以下三行（示例以 Material Theme 为准）：
{
"theme": "Material-Theme.sublime-theme",
"color_scheme": "Packages/Material Theme/schemes/Material-Theme.tmTheme",
"file_icons": true
}
改完必须关闭并重启 Sublime Text —— UI: Reload Theme 不刷新图标缓存。
为什么 .env、.yml 这些文件没图标？需要手动映射扩展名
A File Icon 默认只识别约 200 种常见后缀（如 .js、.py、.md），.env、.yml、.prettierrc 等配置类文件不在默认列表里。这不是 bug，是设计如此。
解决方式不是换插件，而是手动绑定图标标识符：
- 打开 Preferences → Package Settings → A File Icon → Settings – User
- 填入
"extensions"映射块（注意是 Settings – User，不是 Default）：
{
"extensions": {
".env": "settings",
".yml": "config",
".prettierrc": "config"
}
}
其中 "settings"、"config" 是插件内置图标名，完整列表见其 Default Settings 中的 icon_names 字段。保存后必须重启，A File Icon: Rebuild Icon Cache 不加载新规则。
图标颜色不对或太淡？检查主题是否支持 colored_folders
部分主题（如 Material Theme）支持文件夹着色，但需额外启用 colored_folders。如果文件夹图标灰扑扑的，可能只是开关没开。
操作路径：Preferences → Package Settings → Material Theme → Settings – User，添加：
{
"colored_folders": true
}
注意：该字段只对 Material Theme 生效；其他主题如 Soda 或 Origami 不支持此特性。若你用的是非 Material 主题却强行加这行，Sublime 会静默忽略，无报错。
另外，图标颜色由主题定义的字体颜色控制，不是 A File Icon 决定的。想微调，得用 Customize Theme 插件重写 sidebar_label 的 font_color，而非改图标插件本身。
别把 A File Icon 当成“图标包”来装
Sublime Text 没有图标包概念 —— 所有侧边栏图标都来自 Octicons 字体，不是 PNG/SVG 图片资源。A File Icon 只是把文件扩展名映射到字体图标的桥梁。
这意味着：
- 你不能“下载一个图标包 ZIP 解压进 Packages/”就生效
- 图标只出现在侧边栏，不影响标签页、系统托盘或文件管理器
- 图标样式完全取决于当前
theme是否加载了 Octicons 字体并定义了对应 glyph
所以优先换主题（如 Material Theme），而不是试图修改图标插件源码。后者极易因 ST4 主题语法更新而失效，且容易引入 JSON 语法错误导致整个 UI 崩溃。
