Sublime Text侧边栏文件夹图标不显示是因为A File Icon默认仅处理文件图标,需手动启用colored_folders并配合支持folder_icon规则的主题(如Material-Theme、Ayu Dark等),同时确保file_icons为true且主题未被ignored_packages禁用。

Sublime Text 侧边栏文件夹图标不会自动出现,colored_folders 默认关闭,必须手动启用并配合支持该特性的主题才能生效。
为什么文件有图标但文件夹还是小三角?
这是最常被忽略的默认行为:A File Icon 插件默认只处理文件图标,对文件夹图标完全不干预。即使你看到 .js、.py 都带颜色,文件夹仍显示为原始小三角,说明 colored_folders 没开。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 填入合法 JSON:
{ "colored_folders": true, "folder_animation": false } -
"folder_animation": false建议一并加上,避免展开/折叠时图标闪烁 - 保存后无需重启,图标通常秒级刷新;若无效,再执行一次
A File Icon: Rebuild Icons
哪些主题真正支持彩色文件夹?
不是所有“带图标”的主题都支持 colored_folders —— 它需要主题的 .sublime-theme 文件里明确定义了 folder_icon 类型的规则,且路径能匹配到 A File Icon 提供的 SVG 资源。
- 明确支持的:
Material-Theme.sublime-theme(需配"material_theme_big_fileicons": true)、ayu-dark.sublime-theme、AFileIcon Dark.sublime-theme - 旧版
Seti_UI、Origami等多数不支持,强行开启只会留空或显示问号 - 检查方式:打开
Preferences → Theme,选中当前主题后,去Packages/对应目录下看.sublime-theme文件是否含"class": "folder_icon"相关 rule
文件夹图标颜色不对或全灰?
常见于误启用了 draw_white_icons 或主题自身覆盖了图标着色逻辑。
- 在
Preferences → Package Settings → A File Icon → Settings中确认"draw_white_icons": false(不是true) - 如果用了
Material Theme,检查用户设置里有没有"material_theme_tree_small": true这类压缩模式——它会禁用彩色文件夹 - 项目级
.sublime-project文件可能硬编码了"theme"或"file_icons",覆盖全局设置,导致颜色突变 - Windows 下若 Sublime 安装在长路径或 OneDrive 同步目录,
icons/子目录权限异常也会导致 SVG 加载失败,表现为图标变灰或缺失
自定义冷门文件夹图标(如 .vscode、.github)
A File Icon 不提供文件夹名映射,只靠扩展名和语法 scope;想让特定文件夹名带图标,得走主题层定制。
- 找到你当前主题的
.sublime-theme文件(如Packages/Material Theme/material-theme.sublime-theme) - 在顶层
"rules"数组开头插入一条新 rule:{ "class": "folder_icon", "settings": ["icon_folder_vscode"], "layer0.texture": "Packages/A File Icon/icons/folder_vscode.png" } - 注意:
"icon_folder_vscode"必须是A File Icon已内置的图标名(查Packages/A File Icon/icons/目录),否则路径 404 - 保存后必须完全退出 Sublime 再重开,
.sublime-theme不支持热重载
真正卡住人的从来不是“怎么装”,而是三者没对齐:插件版本(必须是 sublimelsp 作者)、主题能力(是否声明 folder_icon)、配置开关(colored_folders 和 file_icons 都得在顶层)。少一个,文件夹图标就永远是那个小三角。

















