a file icon 插件需同时满足三个条件才能显示图标:启用支持图标的主题、在用户设置顶层启用"file_icons": true、package control能联网;还需按系统添加对应开关并手动重建图标缓存。

A File Icon 插件本身不显示图标,它只负责把扩展名映射成 CSS class;真正决定图标长什么样的,是当前启用的 UI 主题 —— 换句话说,装上插件 ≠ 看到图标,主题不匹配或没启用,图标就永远是空白。
为什么装完 A File Icon 侧边栏还是没图标?
这不是插件没装好,而是三个条件没同时满足:
- 当前
theme必须是支持图标的主题(如Adaptive.sublime-theme、Material-Theme.sublime-theme,而Default.sublime-theme和Slush & Poppies不支持) -
"file_icons": true必须直接写在Preferences → Settings – User的顶层 JSON 中,不能嵌套在"theme"或其他对象里 - Package Control 必须能联网访问
packagecontrol.io—— 如果命令面板里搜Package Control: Install Package显示 “no packages available”,大概率是网络被拦截
验证方式:打开控制台(View → Show Console),执行 import urllib.request; print(urllib.request.urlopen('https://packagecontrol.io').getcode()),返回 200 才算通。
如何让 .env、.toml、.astro 这类后缀显示图标?
插件默认不识别这些扩展名,但支持手动映射,格式极其严格:
一款AI开发辅助工具,主要用于从 AI 编程会话日志(Clawdbot、Claude Code、Codex)中提取对话记录。该功能用于在用户要求导出提示词历史、会话日志或 `.jsonl` 格式的会话文件时使用,适合需要提升相关任务效率的用户。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加字段:
"file_extensions": {"env": "settings", "toml": "config", "astro": "html"} - 左侧键名必须小写、无点、纯扩展名(
"env"✅,".env"❌,"ENV"❌) - 右侧值必须是插件内置图标名(查
Packages/AFileIcon/icons/下的文件名,如settings.svg、config.svg) - 拼错或图标名不存在,会 fallback 成空白文档图标,且不报错、不提示
Linux/macOS/Windows 各自要加什么配置?
不同系统需显式开启对应开关,否则图标可能不加载:
- Linux 用户必须在
Settings – User中加:"file_icons_linux": true - macOS 用户必须加:
"file_icons_osx": true - Windows 用户必须加:
"file_icons_win": true - 如果用了 Soda 或 Flatland 这类老主题,还得额外加:
"file_icons_soda": true或"file_icons_flatland": true
这些配置都得写在顶层,和 "file_icons": true 并列,不能缩进或包在别的 object 里。
图标缓存不刷新,改了设置也没用怎么办?
插件不会自动监听配置变化,必须手动重建缓存:
- 用命令面板(
Ctrl+Shift+P/Cmd+Shift+P)运行:AFileIcon: Rebuild Icon Cache - 比重启更快生效,尤其适合调试自定义映射时反复验证
- 如果图标错位、重复或显示异常,先运行
AFileIcon: Purge Icon Cache清空旧缓存,再重建 - 注意:某些 ST4 版本(如 macOS 上的 4.42xx)即使运行了重建命令,也必须重启才能加载新图标
最常被忽略的是「系统专属开关」和「缓存重建」这两步 —— 尤其在 Linux 或 macOS 上,漏掉 file_icons_osx 或 file_icons_linux,图标就永远出不来,连错误提示都没有。










