图标不显示需先确认theme和file_icons同时生效：theme必须设为支持图标的主题（如material-theme.sublime-theme），file_icons须置于settings–user顶层json中并设为true，且重启sublime text；.env等文件需在a file icon的settings–user中通过extensions手动映射图标标识符；文件夹图标需启用colored_folders并确保主题支持；优先换主题而非改主题，避免语法错误，并检查项目级设置是否覆盖全局。
图标不显示？先确认 theme 和 file_icons 是否同时生效
装了 A File Icon 却没图标，八成不是插件没装，而是当前 "theme" 没指向支持图标的主题，或者 "file_icons" 没开在 Preferences → Settings – User 的最外层 JSON 里。
常见错误现象：
-
"theme": "Default.sublime-theme"或"theme": "Adaptive.sublime-theme"—— 这俩默认不渲染图标 -
file_icons被写在"view_settings"或"theme_settings"对象内部 —— Sublime 直接忽略 -
"ignored_packages": ["A File Icon"]还留在设置里 —— 插件被静默禁用
验证方法：打开 Preferences → Settings – User，确保有且仅有：
{
"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 种扩展名，.env、.prettierrc、.editorconfig 这类配置文件常被跳过。解决方式不是换插件，而是手动绑定图标标识符。
操作路径：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 不加载新规则。
文件夹图标为什么还是小三角？
A File Icon 默认只处理文件图标，colored_folders 是关闭状态。即使所有 .js、.py 都带图标，文件夹仍显示为原始小三角。
启用方式：打开 Preferences → Package Settings → A File Icon → Settings – User，填入：
{
"colored_folders": true,
"folder_animation": false
}
关键点：
-
"folder_animation": false建议一并加上，避免展开/折叠时图标闪烁或错位 - 不是所有主题都支持
colored_folders—— 必须主题的.sublime-theme文件里有"class": "folder_icon"规则，Material-Theme.sublime-theme和ayu-dark.sublime-theme明确支持 - 若文件夹图标全灰，检查是否误启了
"draw_white_icons": true，或主题启用了压缩模式（如"material_theme_tree_small": true）
换主题比改主题快得多
直接编辑 .sublime-theme 文件风险高：JSON 语法错一点，整个侧边栏可能空白；图标路径写错，图标就变成问号；尺寸不对（非 16×16 或 32×32），渲染模糊或截断。
更稳妥的做法是换主题：
- 按
Ctrl+Shift+P→ 输入UI: Select Theme→ 选带.sublime-theme后缀的，比如Material-Theme.sublime-theme或ayu-dark.sublime-theme - 别信“已安装=已启用”——某些主题（如 Flatland）需额外加
"file_icons_flatland": true；macOS 用户漏掉"file_icons_osx": true也会失效 -
Material Theme + A File Icon是最稳组合：前者自带完整图标集和高对比度配色，后者补全冷门扩展名映射，基本覆盖所有开发场景
真正容易被忽略的是：项目级 .sublime-project 文件可能硬编码了 "theme" 或 "file_icons"，会覆盖全局设置，导致部分项目图标异常。
