必须先安装Package Control,否则图标主题安装无效;按Ctrl+Shift+P输入Package Control: Install Package可验证是否已装,未装则需通过控制台执行官网最新脚本并重启Sublime。

装图标主题前必须确认 Package Control 已就位
没装 Package Control,后面所有操作都白搭——Sublime 不会报错,只会静默跳过安装。按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)调出命令面板,输入 Package Control: Install Package,能执行说明已装好;如果提示 “command not found”,得先装 Package Control:按 Ctrl+` 打开控制台,粘贴官网最新安装脚本(2026 年仍有效),回车执行,再重启 Sublime。
图标主题 ≠ 图标插件,Material Theme 是最省心的选择
很多人搜 “图标主题” 却装了 A File Icon,结果图标不显示——因为 A File Icon 是插件,只提供图标映射逻辑;真正负责绘制图标的,是 UI 主题里的 .sublime-theme 文件。而 Material Theme 这类 UI 主题自带完整图标规则,一步到位,不用额外配开关、不用手动写 "file_icons": true。
实操建议:
- 在命令面板中执行
Package Control: Install Package→ 输入Material Theme→ 回车安装 - 安装完立刻执行
Material Theme: Activate theme(不是手动改配置!这个命令会自动写对"theme"、"color_scheme"和图标相关参数) - 若命令面板里搜不到
Activate theme,说明插件未加载,重启 Sublime 后重试
别用 Default 或 Adaptive 主题指望显示图标
Default.sublime-theme 和 Adaptive.sublime-theme(哪怕名字带 “Adaptive”)都不含任何图标渲染规则。即使你装了 A File Icon、开了 "file_icons": true,侧边栏图标区域也永远是空白或问号。
真正支持图标的主题有:
-
Material-Theme.sublime-theme(推荐,自带图标 + 暗色/亮色多变体) -
ayu-dark.sublime-theme(轻量,原生支持图标) -
Theme - Soda(需确认版本 ≥ 3.0,老版本无图标支持)
验证当前主题是否生效:按 Ctrl+Shift+P → 输入 UI: Select Theme,看带 ✔️ 的那一行是否为上述主题名;路径必须一字不差,比如 "theme": "Material-Theme.sublime-theme",漏掉 .sublime-theme 后缀或大小写错,Sublime 就直接回退到默认主题。
图标不显示?优先检查这三处硬性配置
90% 的“装了没反应”问题卡在这三点,重装插件反而浪费时间:
-
"file_icons": true必须出现在用户设置(Preferences → Settings – User)的 JSON 顶层,不能嵌套在"theme"或其他对象里;写成"file_icons": "true"(字符串)或"file_icon": true(拼写错)都无效 - 检查
file_exclude_patterns或folder_exclude_patterns是否误加了"*.md"这类通配符——A File Icon会跳过所有被排除路径的文件 - 如果你用了
.sublime-project,确认里面没覆盖"theme"或"file_icons",项目级设置会压过全局设置
临时验证法:切回 Adaptive.sublime-theme,再运行命令 AFileIcon: Rebuild Icon Cache,比重启更快见效。但注意:Material Theme 用户不该装 A File Icon,二者冲突会导致图标错位或消失。


















