Sublime Text 默认不显示文件图标是因其原生UI不依赖系统图标机制，需通过A File Icon插件注入CSS类实现；该插件要求ST4.4192+、禁用ignored_packages、配合默认主题，并支持自定义扩展名映射。
为什么 Sublime Text 默认不显示文件图标
Sublime Text 原生 UI 不依赖操作系统资源管理器的图标渲染机制，侧边栏只显示文件名和扩展名，不加载系统图标缓存或第三方图标主题——这是设计使然，不是 bug。想让 sidebar 显示图标，必须靠插件注入 CSS 并绑定文件类型到图标 class。
安装 A File Icon 插件是唯一可靠方案
目前稳定、持续维护、适配 Sublime Text 4 的图标插件只有 A File Icon。它不改 Sublime 内核，而是通过监听 on_activated 和 on_post_save 事件动态为每个 view 注入图标 class，并配套提供完整 CSS 规则。
- 用
Package Control: Install Package搜索并安装A File Icon，别手动下载 zip 或 git clone - 装完后重启 Sublime（必要），否则图标 class 不生效
- 插件会自动启用；如被禁用，检查命令面板中是否有
A File Icon: Enable - 不兼容旧版
Theme - Soda等自定义主题，若用了这类主题，需切换回Adaptive或Default才能正常显示图标
图标不显示？优先检查这三处
90% 的“没图标”问题都出在路径、主题或缓存上，不是插件坏了。
-
A File Icon要求 Sublime Text 4.4192+，低于此版本会静默失效（无报错） - 检查是否启用了
ignored_packages：打开Preferences → Settings – User，确认"ignored_packages": []或至少不含"A File Icon" - 图标 CSS 缓存可能卡住：关闭 Sublime，删掉
Cache/A File Icon/目录（路径可通过Preferences → Browse Packages…进入Packages后向上一级找Cache）
自定义图标映射需要改 JSON 文件
插件默认覆盖主流语言和配置文件，但遇到冷门扩展（比如 .tfvars、.env.local）就得手动加规则。改的是 Packages/User/AFileIcon.sublime-settings 里的 file_extensions 字段。
- 不要直接改插件自带的
AFileIcon.sublime-settings（会被更新覆盖） - 示例：给
.astro文件加图标，添加：{"file_extensions": {"astro": "html"}}表示复用 HTML 图标 - 图标名必须来自插件内置集合（如
html、js、folder），拼错就 fallback 成默认文档图标 - 改完保存，无需重启，但当前已打开的标签页要重新打开才生效
图标显示本质是 CSS class 绑定 + 主题支持，不是 Sublime 自身能力。一旦换主题或升级失败，第一反应不该是重装插件，而是查 ignored_packages 和缓存路径——这两处最常被忽略。
