a file icon图标不显示的根本原因是插件与主题未协同生效；需确认package control正常联网、插件已启用、"file_icons": true置于设置顶层、切换支持图标主题（如adaptive或material theme）、正确配置"theme"和"icon_theme"字段，并彻底重启sublime text。
图标不显示？先确认 A File Icon 和主题是否真正协同生效
Sublime Text 本身不支持“安装图标包”这个操作——它没有 VS Code 那样的图标主题 marketplace，也没有加载 PNG/SVG 图标的机制。所谓“精美图标”，实际是 A File Icon 插件 + 支持图标的 UI 主题（如 Adaptive、ayu 或 Material Theme）共同作用的结果，所有图标都来自 Octicons 字体，不是图片资源。
常见错误现象：Package Control: Install Package 能调出但列表为空；装完 A File Icon 后侧边栏仍是空白图标；切换主题后图标突然消失。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）必须能弹出命令面板；不能，说明Package Control没装好或被拦截 - 打开
Preferences → Package Settings → A File Icon → Settings，能看到 JSON 文件才表示插件已就位 -
"file_icons": true必须写在Preferences → Settings – User的顶层 JSON 中，不能嵌套在"theme"或其他对象里 - 默认的
Default.sublime-theme和Slush & Poppies主题不渲染图标，必须换用Adaptive.sublime-theme或第三方主题并查其文档是否需额外开关（如"file_icons_material_theme": true）
配置 Settings – User 时大小写和后缀一个都不能错
主题和图标启用靠的是两个严格匹配的字符串字段："theme" 和 "icon_theme"。拼写偏差（空格、连字符、大小写、后缀缺失）都会导致 Sublime 静默忽略，无报错、无提示、界面毫无变化。
例如使用 Material Theme 和 A File Icon 时，正确配置是：
{
"theme": "Material-Theme.sublime-theme",
"icon_theme": "A File Icon"
}
常见错误：
-
"theme": "Material Theme"→ 错，缺连字符和.sublime-theme后缀 -
"icon_theme": "a file icon"→ 错，大小写敏感，必须是"A File Icon" - 只配了
"theme"没配"icon_theme"→ UI 变了，但图标不出现 - 改的是
Settings – Default→ 下次升级会被覆盖，无效
.env、.yml 等冷门扩展名怎么加图标？手动映射就行
A File Icon 内置覆盖约 200 种常见扩展名（.js、.py、.md 等），但对 .env、.toml、.conf、.yml 默认不识别。这不是插件缺陷，也不用换“图标包”，只需在插件设置里追加映射规则。
操作路径：Preferences → Package Settings → A File Icon → Settings – User，添加：
{
"file_extensions": {
"env": "dotfile",
"yml": "yaml",
"toml": "config"
}
}
注意点：
- 键名是扩展名（不含点），值是内置图标名（如
"dotfile"、"yaml"、"config"），不是任意字符串 - 可查
A File Icon官方文档或源码里的icons.json获取合法图标名列表 - 映射后无需重启，保存即生效
重启不是可选项，是硬性步骤
即使配置全对、插件已安装、主题已切换，图标仍不渲染？大概率卡在没重启。Sublime 不像浏览器那样热重载 UI 主题和图标字体，它需要完整进程重启才能加载新主题的 glyph 映射表和 A File Icon 注入的图标数据。
别信“重载主题”或“切换方案”这类快捷方式——它们只刷新部分样式，不触发图标渲染管线。必须彻底关闭所有 Sublime 进程（包括后台残留），再重新打开。
容易被忽略的细节：
- Windows 任务管理器里检查是否有隐藏的
sublime_text.exe进程 - macOS 上用
Activity Monitor查找并强制退出Sublime Text - Linux 用户注意桌面环境可能自动拉起守护进程，建议用
pkill sublime清理
