A File Icon图标显示需同时满足三条件：插件通过Package Control正确安装、UI主题支持图标渲染（如Adaptive/Material Theme）、用户设置顶层含"file_icons": true；冷门后缀需手动映射至内置图标名。
Sublime Text 本身不支持“安装图标包”——它没有图标主题 marketplace，也不加载 PNG/SVG 文件。所谓 FileIcons 图标，实际是 A File Icon 插件 + 支持图标的 UI 主题协同工作的结果，所有图标都来自 Octicons 字体。
为什么装了 A File Icon 却没图标？
这不是插件没装好，而是三个条件没同时满足：
-
A File Icon插件已通过Package Control: Install Package正确安装（验证方式：打开Preferences → Package Settings → A File Icon → Settings能编辑 JSON） - 当前 UI 主题支持图标渲染：
Default.sublime-theme和Slush & Poppies默认关闭；Adaptive、Material Theme、ayu等需手动启用图标支持 -
"file_icons": true必须出现在Preferences → Settings – User的顶层 JSON 中，不能嵌套在"theme"或其他对象里
常见错误：用户复制了别人配置但漏删了 "file_icons": false，或用了 Flatland 主题却没加 "file_icons_flatland": true。
如何让 .env、.toml、.astro 这类后缀显示图标？
A File Icon 内置约 200 种扩展名映射，但冷门后缀默认不识别。必须手动映射，不是换主题或重装插件能解决的：
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加字段
"file_extensions"，例如：{"env": "settings", "toml": "config", "astro": "html"} - 图标名（如
settings）必须来自插件内置集合，可查Packages/AFileIcon/icons/下的文件名（不含.svg后缀），拼错就 fallback 成空白文档图标
图标显示异常或刷新不生效怎么办？
别急着重启或重装，先做这几件事：
- 运行命令
A File Icon: Rebuild Icons（不是FileIcons: Rebuild，旧命名已弃用）——它会重新生成图标缓存并拉取字体资源 - 右键侧边栏 →
Refresh Folders，强制重绘 - 检查控制台：
View → Show Console，执行import urllib.request; print(urllib.request.urlopen('https://packagecontrol.io').getcode())，确认返回200（否则Package Control根本连不上源） - 若用 macOS，确保
"file_icons_osx": true在用户设置中；Windows/Linux 同理补上对应开关
最易被忽略的是：图标只渲染在侧边栏，不影响标签页、系统文件管理器或项目内图标路径。所有自定义都围绕 file_extensions 映射和主题兼容性展开，没有“全局图标包切换”这回事。
