当前启用的图标主题名是 Settings – User 中 "icon_theme" 字段的值,必须与已安装插件包名完全一致(如 "A File Icon"),且需重启 Sublime Text 才生效;该值缺失、为空、拼写错误(大小写/空格/连字符不符)或与 UI 主题冲突均会导致图标不显示。

怎么确认当前启用的图标主题名
Sublime Text 不会在界面任何地方直接显示“当前图标主题”,它只认 Settings – User 里 "icon_theme" 字段的值——这个值必须和已安装插件的包名完全一致,否则就静默失效。
最可靠的做法是打开 Preferences → Settings – User,检查是否存在这一行:
{"icon_theme": "A File Icon"}
如果存在,那当前图标主题就是 A File Icon;如果不存在或值为空、拼错(比如写成 "a file icon" 或 "AFileIcon"),图标就不会加载。
注意:"icon_theme" 和 "theme" 是两个独立字段,缺一不可。只配了 theme,图标照样不出现。
为什么图标没显示?先查这三项
即使你确定装了图标插件(如 A File Icon),图标仍不显示,大概率卡在这三个点上:
-
Preferences → Settings – User里没写"icon_theme"字段,或值拼写错误(大小写、空格、连字符全要对) - 没重启 Sublime Text:图标插件安装/配置后必须完全退出再重开,否则不会渲染
- 文件后缀未被图标包识别:比如
.env、.yml、.tsx默认可能无图标,需手动在Preferences → Package Settings → A File Icon → Settings中添加file_extensions映射
如何验证图标主题是否真正生效
不能只看侧边栏有没有小图标——有些主题(如 Material Theme)自带基础图标,但和 A File Icon 的图标集不兼容,会互相覆盖。
实操验证步骤:
- 关闭所有窗口,只打开一个空白文件
- 右键侧边栏 →
Add Folder to Project...,加一个含多种后缀的目录(如含.py、.md、.json、.gitignore) - 观察不同文件图标的样式:如果全是统一风格的扁平彩色图标,说明
A File Icon生效;如果只有部分有图标、或图标风格混杂(比如文件夹是圆角蓝标、.py是方块黄标),说明主题与图标包冲突或配置未对齐
这时该去 Preferences → Package Settings → [图标包名] → Settings 看是否有禁用开关,或检查 theme 是否启用了自带图标的 UI 主题(如 Material Theme 自带 material_file_icons 开关)。
图标主题和 UI 主题不是一回事
很多人混淆这两者:theme 控制侧边栏背景、标签页样式、滚动条等整体 UI;icon_theme 只负责替换文件/文件夹的小图标,且依赖独立插件提供图标资源。
常见误区:
- 以为装了
Material Theme就自动有了全套图标——其实它默认只启用自身精简图标集,要完整图标得额外配A File Icon并关掉它的内置图标 - 在
Settings – Default里改icon_theme——无效,必须改Settings – User - 看到侧边栏有图标就认为图标主题生效了——可能只是 UI 主题自带的 fallback 图标,不是你装的那个图标包
真正生效的标志只有一个:图标样式、颜色、细节完全匹配你安装的图标插件文档里的示例图,且所有你手动添加的扩展名都正确映射到了对应图标。


















