A File Icon需通过Package Control安装作者sublimelsp的正版并重启生效,仅兼容sidebar_tree主题(如Soda、Material Theme),且须检查排除规则、项目配置及多窗口插件同步问题。

Sublime Text 本身不支持文件图标,A File Icon 只是用 CSS 覆盖了侧边栏文字前的默认小方块——它不生成真实图标文件,也不改变系统或项目结构。
怎么装 A File Icon 才不冲突
别用 Package Control 直接搜 “A File Icon” 并安装,那会装错包(实际是旧版或镜像分支)。正确做法是:
- 打开 Package Control →
Package Control: Install Package - 输入并选中
A File Icon(作者是sublimelsp,不是kkga或其他) - 装完后重启 Sublime Text —— 不重启,图标不会生效
- 如果已装错,先用
Package Control: Remove Package卸载,再重装
A File Icon 需要配什么主题才显示图标
它只在支持 sidebar_tree 的 UI 主题里工作。默认的 Adaptive 或 Default 主题不支持,图标区域会留白或显示问号。
- 推荐搭配
Theme - Soda、Material Theme或ayu - 装好主题后,在
Preferences → Theme里选对应项(如Material-Theme.sublime-theme) - 部分主题需额外开启图标开关,比如
Material Theme要在用户设置里加:"material_theme_small_file_icons": true
图标没变?检查这三处硬编码配置
常见“装了但没反应”,往往卡在这几个地方:
-
file_exclude_patterns或folder_exclude_patterns里写了"*.md"这类通配符 ——A File Icon会跳过被排除的文件,不渲染图标 - 项目里有
.sublime-project,且里面覆盖了"theme"或"color_scheme",但没同步更新图标相关设置 - 你打开了多个窗口,只在其中一个里装了插件,而当前编辑的文件在另一个无插件的窗口中
图标样式本质是字体图标 + CSS 规则,没有“高清”“矢量缩放”概念;换主题或改字号时,图标可能错位或截断——这不是 bug,是 Sublime 的渲染限制。真要稳定显示,就别频繁混搭主题和插件版本。

















