a file icon 无图标需同时满足三条件：package control 正常联网并成功安装插件（作者 sublimelsp）、主题兼容（如 material theme）且启用 "file_icons": true（布尔值，顶层配置）、重启 sublime text 以注入 css 规则。
装了 A File Icon 却没图标？不是插件没装上，而是 Package Control 没连上、主题不兼容、或 "file_icons": true 没写对位置——三者缺一不可。
Package Control 能不能联网，决定插件能不能装
按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）必须能呼出命令面板；呼不出说明 Package Control 根本没装好或被拦截。
- 输入
Package Control: Install Package后空白/卡住 → 检查公司代理、杀毒软件、packagecontrol.io是否被屏蔽 -
Preferences → Package Settings里没有 Package Control 项 → 去packagecontrol.io复制对应系统的安装代码，粘贴进View → Show Console执行 - 列表加载后，**手动输入
A File Icon并回车**，鼠标悬停看右下角 author 字段：必须是sublimelsp；kkga等分支已停止更新，图标覆盖率低、Sublime Text 4 兼容差
装完必须重启，否则图标规则不注入
A File Icon 不靠“启用”按钮生效，它依赖 Sublime 重载 .sublime-theme 文件来注入 CSS 规则。不重启，侧边栏永远只显示文字或问号。
- 重启前确认已卸载旧版本：先执行
Package Control: Remove Package，再重装A File Icon（作者sublimelsp） - 重启后仍无图标？别急着重装，先检查下一步
图标显示靠主题 + 配置双生效，不是插件单方面的事
A File Icon 本身不渲染图标，只提供字体和映射规则；真正画图的是 UI 主题里的 .sublime-theme 文件。
-
"file_icons": true必须直接写在Preferences → Settings – User的顶层 JSON，不能嵌套在"theme"或其他对象里；写成"file_icons": "true"（字符串）或"file_icon": true（拼错键名）都无效 -
Default.sublime-theme和Adaptive.sublime-theme默认不支持图标；必须换用Material-Theme.sublime-theme、ayu或Theme - Soda - 用
Material Theme还需额外加一行："material_theme_small_file_icons": true，否则图标可能被压成小方块甚至消失
冷门后缀没图标？不是漏装，是设计上留给用户自定义
.env、.toml、.tfvars、.astro 这类扩展名默认不绑定图标，但你不需要重装插件。
- 路径：
Preferences → Package Settings → A File Icon → Settings – User - 添加字段，例如：
"icon_file_extensions": {"env": "settings", "toml": "config"} - 注意：映射值（如
"settings"）必须是插件自带的图标名，可在插件目录下的icon_map.json里查到 - 若想让
.astro按 HTML 类型匹配图标，得去对应语法包确认其 scope 是什么（比如source.html），再配icon_scope_map
最容易被忽略的其实是 file_exclude_patterns：如果它误加了 "*.md" 这类通配符，A File Icon 会直接跳过这些路径，不渲染任何图标。项目级设置（.sublime-project）也可能覆盖全局配置，记得检查是否压过了 "file_icons": true。
