a file icon 图标不显示需同时满足三条件：安装 sublimelsp 版插件、启用支持图标的 ui 主题（如 material theme）、用户设置中顶层配置 "file_icons": true；还需排除文件路径误被过滤，并手动添加冷门后缀映射。
装了 A File Icon 却没图标？大概率是没配对主题、没开开关、或根本没重启——它不靠“启用”按钮生效，而是靠三件套同时就位：插件 + 支持图标的 UI 主题 + "file_icons": true 配置。
怎么装对 A File Icon（别被 Package Control 搜出来一堆同名包坑了）
Package Control 里搜 A File Icon，会列出多个结果。必须选作者是 sublimelsp 的那个，不是 kkga 或其他镜像分支。装错版本会导致图标规则缺失或与 Sublime Text 4 不兼容。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package - 等列表加载完，**手动输入
A File Icon并回车**，在下拉项中确认作者字段为sublimelsp - 装完立刻重启 Sublime Text —— 不重启，
.sublime-theme文件不会重载，图标区域永远空白或显示问号 - 如果已装错，先执行
Package Control: Remove Package卸载，再重装
为什么图标还是不显示？检查这三项硬编码配置
图标是否渲染，和 Settings 里的 "file_icons": true 直接挂钩，但它必须出现在用户设置（Preferences → Settings – User）的顶层 JSON 中，不能嵌套在 "theme" 或其他对象里。
-
"file_icons": true必须存在且为布尔值true；写成字符串"true"或漏掉都会失效 - 检查
file_exclude_patterns或folder_exclude_patterns是否误加了"*.md"这类通配符 —— A File Icon 会跳过所有被排除的文件路径，不渲染图标 - 如果你用的是
.sublime-project，确认里面没覆盖"theme"或"file_icons"，否则项目级设置会压过全局设置
哪些主题能显示图标？Adaptive 和 Default 默认不行
A File Icon 本身不提供图标，只提供图标映射逻辑；真正画图的是 UI 主题里的 .sublime-theme 文件。默认的 Default.sublime-theme 和 Adaptive.sublime-theme 不含图标规则，所以即使插件装对、开关开了，图标区也留白。
- 推荐直接换主题：
Material Theme、ayu、Theme - Soda都原生支持，安装后在Preferences → Theme里选对应项（如Material-Theme.sublime-theme） - 部分主题需额外开启图标开关：比如
Material Theme要在用户设置里加"material_theme_small_file_icons": true - 别指望
Preferences → Settings里有"sidebar_icons"这种键 —— Sublime 没这个配置项，图标完全由主题文件控制
怎么让 .env、.toml 这类冷门后缀也出图标
A File Icon 内置约 200 种扩展名映射（.js、.py、.md 等），但 .env、.toml、.yml 默认不识别。这不是插件缺陷，而是需要手动补映射规则。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加
"file_extensions"字段，例如：
{
"file_extensions": {
"env": "dot",
"toml": "file_text",
"yml": "file_yaml"
}
}
其中右侧值必须是 A File Icon 内置的图标名（见插件文档或源码 A File Icon.sublime-settings 中的 icon_names 列表），不是随便写的字符串。
图标本质是字体（Octicons）+ CSS 规则，没有“高清缩放”概念；换主题、调字号、切高 DPI 模式时图标错位或截断，是 Sublime 渲染机制限制，不是 bug。真要稳定，就别混搭主题版本和插件版本——一个主题配一个插件版本，少折腾。
