图标不显示主因是未启用AFileIcon配套主题、缓存未清除或语法未绑定；需先选中AFileIcon主题，再删CachedIcons目录并重启，最后确保文件语法正确识别。
图标不显示，八成是缓存或主题没配对
AFileIcon 安装完图标不出现，不是插件坏了，而是 Sublime 没“认出”它该用什么主题渲染图标。它本身不提供视觉样式，只负责把 .js、.py 这类扩展名映射到图标名（如 file_type_js），最终显示靠的是你选的 .sublime-theme 文件里有没有对应定义。所以第一步永远不是重装插件，而是确认是否启用了带图标的主题。
- 打开 Preferences → Theme…，向下滚动，找以
AFileIcon开头的主题（如AFileIcon Dark.sublime-theme），选中它 - 别用
Adaptive.sublime-theme或Default.sublime-theme—— 它们压根没定义文件图标规则 - 如果列表里没有
AFileIcon主题，说明插件安装后未正确注册主题资源，需重启 Sublime 或手动触发重建
缓存卡住图标，就清掉 CachedIcons
Sublime 会把图标渲染结果缓存在 Data/CachedIcons/ 目录下，一旦映射关系变更（比如你改了 icon_map.json）或缓存损坏，旧图标就一直挂着不更新。这不是 Bug，是设计如此 —— 但它容易被当成“插件失效”。
- 完全退出 Sublime Text（Mac 上注意右键 Dock 图标选 “退出”，别只是关窗口）
- 进入数据目录：
Windows：%APPDATA%\Sublime Text 3\Data\CachedIcons
macOS：~/Library/Application Support/Sublime Text 3/Data/CachedIcons
Linux：~/.config/sublime-text-3/Data/CachedIcons - 删除该目录下所有内容（留空即可，不用删目录本身）
- 重启 Sublime，再执行命令面板里的
AFileIcon: Rebuild Icon Cache
自定义文件类型图标不生效？检查三处硬性条件
想让 .env 或 .toml 显示专属图标，光改 icon_map.json 不够。AFileIcon 的匹配链有三个环节，缺一不可：
当用户提及 GitHub URL，或要求分析、审查、探索或理解任意 GitHub 项目、仓库或代码库时，请使用此技能。触发条件包括以下短语：“分析这个项目”、“看看这个仓库”、“analyze this repo”、“what does this project do”，或消息中包含任何 github.com URL。
-
语法识别要到位：Sublime 必须把该文件识别为对应语言，否则不会查扩展名映射。检查右下角状态栏是否显示
Plain Text—— 如果是，需先给文件绑定语法（右键 →Set Syntax → XXX），或在.sublime-syntax文件中确保file_extensions包含你的扩展名 -
映射名要存在：在
Packages/User/AFileIcon/icon_map.json中加的键如"*.env"，值必须是主题里已定义的图标名，例如"file_type_dotenv"；不能随便写"my_env_icon"，除非你同时往主题 SVG 资源里加了同名图标 -
主题资源要加载：AFileIcon 主题包里的
icons/文件夹必须存在且可读。若用的是第三方主题（如 Material Theme），它得明确声明兼容 AFileIcon —— 否则即使映射对了，也会 fallback 成默认文档图标
Git 状态图标也不见？别混用 GitGutter 和 AFileIcon 的职责
很多人以为 GitGutter 负责侧边栏 Git 图标，其实它只管编辑区 gutter（行号旁）的修改标记；侧边栏里的绿色圆点、蓝色箭头等 Git 状态图标，是 AFileIcon 在检测到项目有 .git 目录后，主动叠加渲染的 —— 前提是你用的是它配套的主题（如 AFileIcon Dark.sublime-theme）。
- 确认项目根目录存在
.git文件夹，且文件已被git add或提交过（untracked 新文件也能显示绿点） - 禁用其他可能覆盖 sidebar 图标的主题插件，比如某些精简版主题会强制隐藏
sidebar_file_icons配置项 - 如果仍不显示，打开命令面板运行
AFileIcon: Toggle Git Integration（部分版本支持），或检查用户设置里是否有"enable_git_status": false
AFileIcon 的图标逻辑藏得深，但每一步都有迹可循。最常被跳过的动作是：没换主题、没清缓存、没确认语法绑定 —— 这三步做完，90% 的“图标不显示”问题就消失了。
