a file icon图标不显示是因为插件只打标签、不画图，需theme、file_icons开关、图标主题三者对齐且重启生效；default/adaptive主题无图标规则，必须换用material-theme等支持主题，并确保"file_icons": true置于settings–user顶层。
图标不显示，90% 是因为 theme、icon_theme、file_icons 三者没对齐，或根本没重启 —— Sublime 不报错，只留白。
为什么装了 A File Icon 还是没图标？
不是插件没装，而是它只负责“打标签”，不负责“画图”。真正渲染图标的，是 UI 主题里的 .sublime-theme 文件。Default 和 Adaptive 这两个自带主题压根没写图标规则，所以哪怕插件和开关都对，图标区也永远空白。
- 必须换用明确支持图标的主题：如
Material-Theme.sublime-theme、ayu-dark.sublime-theme、AFileIcon Dark.sublime-theme - 别信“名字带 Dark/Light 就支持图标”——得看主题包里
.sublime-theme文件是否包含icon_file_type或icon_folder类名定义 - 临时验证：切回
Adaptive.sublime-theme→ 执行命令AFileIcon: Rebuild Icon Cache→ 再切回你的主题，比全量重启更快见效
file_icons 开关为什么无效？
file_icons 必须是顶层布尔值 true，且不能嵌套在 "theme" 或其他对象里。写成字符串 "true"、漏掉、拼成 file_icon 或放在项目级 .sublime-project 里，都会静默失效。
- 打开
Preferences → Settings – User，确认 JSON 顶层有这一行："file_icons": true - 检查
.sublime-project是否覆盖了"file_icons"或"theme"—— 项目设置优先级高于用户设置 - 如果用了
folder_exclude_patterns（比如["*.md"]），A File Icon 会跳过整个路径，图标直接不触发
theme 和 icon_theme 配置错在哪？
这两个字段大小写、空格、后缀一个字符都不能错。Sublime 静默忽略错误值，退回到默认界面，不提示、不报错。
-
"theme"值必须是完整文件名 +.sublime-theme后缀，例如："Material-Theme.sublime-theme"（不是Material Theme，也不是Material-Theme） -
"icon_theme"值必须与 Package Control 里显示的包名完全一致，例如："A File Icon"（不是a file icon，也不是AFileIcon） - 装完图标插件后必须重启 Sublime Text ——
.sublime-theme只在启动时加载，热重载不生效 - 用
Ctrl+Shift+P输入UI: Select Theme，看带 ✔️ 的当前主题名，复制粘贴进设置最稳妥
哪些后缀不显示图标？怎么加？
A File Icon 默认只识别常见语言和项目文件（.js、.py、package.json、README.md）。像 .env、.yml、.tsx 或自定义后缀（如 .conf）需要手动映射。
- 打开
Preferences → Package Settings → A File Icon → Settings - 在右侧用户设置中添加
file_extensions规则，例如：{ "file_extensions": { "env": "settings", "yml": "yaml", "conf": "config" } } - 键是小写后缀名（不含点），值是图标类型名（参考插件文档里的
icon_*类名） - 改完保存，不用重启，但需执行
AFileIcon: Rebuild Icon Cache刷新缓存
最容易被忽略的是：图标渲染依赖三重协同 —— 插件提供 class 名、主题提供绘制规则、设置开启开关。少一环就空白，而且 Sublime 从不告诉你哪一环断了。
