sublime text 文件图标仍为方块是因为 ui 主题不控制图标,需单独安装并配置 a file icon 插件,且必须重启、正确设置 icon_theme 和 file_icons,并检查扩展名映射与主题/插件冲突。

Sublime Text 为什么装了深色主题,文件图标还是方块?
因为 UI 主题(如 One Dark.sublime-theme 或 Material-Theme.sublime-theme)只管菜单、侧边栏、标签页的样式,**不负责文件图标**。图标由独立插件提供,且必须手动启用——装完不配,等于没装。
安装 FileIcons 或 A File Icon 的实操要点
推荐优先选 A File Icon:更新更勤、适配 ST4、图标密度高;FileIcons 更轻量但维护较慢。两者都不兼容,别同时装。
- 用
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Package Control: Install Package→ 回车 → 搜索A File Icon→ 点击安装 - 安装后**必须重启 Sublime Text**,否则图标不会渲染(不是卡顿,是彻底不触发)
- 确认是否生效:右键任意文件 → 若出现
Rebuild File Icons Cache选项,说明插件已加载
Settings – User 里必须加的两行配置
仅安装插件不够,还得在 Preferences → Settings – User 中补全这两项,缺一不可:
{
"icon_theme": "A File Icon",
"file_icons": true
}
注意:"icon_theme" 值必须和 Package 名**完全一致**(大小写、空格、连字符都不能错);"file_icons": true 是开关,设为 false 或漏掉,图标就消失。
- 错例:
"icon_theme": "a file icon"(小写)→ 静默失效 - 错例:
"icon_theme": "AFileIcon"(无空格)→ 找不到包,回退默认 -
"file_icons": true在 ST4 中仍是必需项,别信“新版自动启用”的说法
图标不显示?先查这三处硬性条件
即使配置全对,图标仍不出现,大概率卡在这三个地方:
-
A File Icon默认只识别常见后缀(.js、.py、.md等),.env、.yml或自定义扩展名需手动映射——进Preferences → Package Settings → A File Icon → Settings添加规则 - 某些 UI 主题(如
Seti_UI)自带图标逻辑,会与A File Icon冲突;此时应禁用其图标功能,或卸载 Seti 的图标部分 - 插件被其他工具覆盖:如果装了
SideBarEnhancements,它默认重绘侧边栏,需进其设置把"draw_sidebar_arrows"设为false,否则图标区域被截断
路径、大小写、重启、冲突插件——这四点没全过一遍,别急着怀疑主题或插件本身有问题。











