图标不显示需同时满足：theme字段值为支持图标主题名且带.sublime-theme后缀、file_icons:true置于Settings–User顶层、安装sublimelsp版A File Icon插件；冷门后缀需手动映射；主题须启用对应图标开关；配置生效前可重建缓存或检查项目设置及排除规则。
图标不显示？先确认 theme 和 file_icons 都配对了
Sublime Text 本身不渲染图标，它只提供挂载点；真正画出图标的，是 theme 文件里的规则，而决定“哪个文件用哪个图标”的，是 A File Icon 插件。两者缺一不可。
必须同时满足三个条件：
-
"theme"字段值必须是支持图标的主题名，且带.sublime-theme后缀，例如"Material-Theme.sublime-theme" -
"file_icons": true必须出现在Preferences → Settings – User的 JSON 顶层，不能嵌套在其他对象里，也不能写成字符串"true" - 装的是作者为
sublimelsp的A File Icon—— Package Control 搜出来的同名包有多个，错装 kkga 或 braver 分支会导致图标规则缺失
常见错误：只改了 theme 没加 file_icons，结果 UI 变了但侧边栏仍是空白方块；或者把 file_icons 写在 "settings":{} 里，Sublime 直接忽略。
为什么 .env、.yml 这类文件没图标？得手动映射
A File Icon 默认只识别主流后缀（如 .js、.py、package.json），对 .env、.toml、.dockerignore 等冷门类型不响应。
解决方法是在 Preferences → Package Settings → A File Icon → Settings 中添加扩展映射：
{
"file_extensions": {
".env": "dotfile",
".yml": "config",
".yaml": "config",
".toml": "config"
}
}注意：dotfile、config 是 A File Icon 内置的图标标识符，不是随便起的名字；主题也得支持这些 class 才能渲染出来——Material Theme 支持，Default 和 Adaptive 不支持。
图标太小或颜色不对？检查主题是否启用图标开关
有些主题（比如 Material Theme）默认关闭小图标模式，导致图标缩成一个像素点，或只显示单色轮廓。
在 Settings – User 中补上对应开关：
-
"material_theme_small_file_icons": true（Material Theme） -
"ayu_colored_folders": true（Ayu 主题，影响文件夹图标颜色） -
"soda_folder_icons": true（Theme - Soda）
这些字段不是通用标准，每个主题有自己的命名习惯，必须查该主题文档或 Package Settings 里的说明项。写错名字或拼错大小写，Sublime 一样静默忽略。
改完配置没反应？重启不是唯一解法
很多情况下重启 Sublime Text 是必须的，因为 .sublime-theme 文件只在启动时加载一次。但频繁重启效率低，可优先试这两个更快验证方式：
- 临时切回
Adaptive.sublime-theme，然后运行命令AFileIcon: Rebuild Icon Cache（命令面板搜）——能立刻刷新图标缓存 - 检查当前是否在
.sublime-project项目中：项目级设置会覆盖全局设置，如果里面写了"file_icons": false或删了"theme"，图标就必然不显示
最易被忽略的一点：文件是否被 file_exclude_patterns 排除了？哪怕只写了 "*.md"，A File Icon 就会跳过所有匹配路径下的文件，图标区域留空也不报错。
