必须先装支持图标的UI主题，否则A File Icon不渲染；它仅提供图标数据，真正决定图标显示的是theme是否含绘制逻辑，file_icons必须置于Settings–User顶层，且安装后需重启Sublime Text。
必须先装支持图标的 UI 主题，否则 A File Icon 不渲染
A File Icon 本身不控制渲染，只提供图标数据；真正决定侧边栏是否显示图标的是当前 theme 是否包含图标绘制逻辑。默认的 Default.sublime-theme 和 Slush & Poppies.sublime-theme 都不支持图标，即使装了插件也完全没反应。
推荐直接用 Material-Theme.sublime-theme 或 Sublime 自带的 Adaptive.sublime-theme（轻量、稳定、无需额外配置）：
-
Adaptive：无需安装额外包，按Ctrl+Shift+P→ 输入UI Theme→ 选Set UI Theme: Adaptive.sublime-theme即可 -
Material Theme：需通过 Package Control 安装，安装后必须在Settings – User中显式设为"theme": "Material-Theme.sublime-theme"，注意连字符和.sublime-theme后缀
file_icons 必须是 Settings – User 的顶层字段，不能嵌套
很多人把 "file_icons": true 写在 "theme" 对象里，或塞进某个插件配置块中，结果图标始终不出现——Sublime 只认最外层 JSON 的这个键。
正确写法（打开 Preferences → Settings – User）：
{
"theme": "Adaptive.sublime-theme",
"file_icons": true
}
常见错误：
- 写成
{"theme": {"name": "Adaptive.sublime-theme", "file_icons": true}}→ 无效 - 漏掉
file_icons字段 → 图标开关默认关闭 - 拼成
file_icon或fileicons→ 静默忽略，无提示
A File Icon 安装后必须重启 Sublime Text 才能加载图标资源
安装插件本身不触发图标重绘，Sublime 在启动时才扫描并注册所有图标标识符。不重启，file_icons: true 就像没写一样。
尤其要注意：如果之前已打开多个窗口，关掉所有实例再重新打开，而不是仅关闭当前窗口。
验证是否生效的小技巧：
- 打开
Preferences → Package Settings → A File Icon → Settings，能看到 JSON 文件即表示插件已加载 - 重启后，检查侧边栏里
.js、.py、package.json这类默认支持的文件是否有了图标 - 如果仍无图标，优先怀疑
theme值写错，或file_icons不在顶层
.env、.yml 等文件没图标？需要手动映射 extensions
A File Icon 默认只覆盖主流语言和通用配置文件，.env、.yml、.toml、.editorconfig 等需手动声明映射关系。
方法：打开 Preferences → Package Settings → A File Icon → Settings – User，添加 extensions 数组：
{
"extensions": {
"env": "settings",
"yml": "yaml",
"toml": "ini",
"editorconfig": "settings"
}
}
其中右侧值是图标标识符（如 yaml、settings），不是文件名；可用标识符列表见插件文档或其 Default Settings 里的 icon_definitions 段。
注意：改完这个设置后无需重启，但要确保 file_icons: true 已全局启用，且主题支持图标渲染。
