a file icon 图标不显示是因插件、主题、设置三者未对齐:插件仅发指令,图标由.theme文件渲染;需确保file_icons设在顶层、主题支持并启用对应选项、禁用列表未屏蔽主题、修改后重启;自定义文件图标需在settings–user中正确绑定内置标识符。

Sublime Text 侧边栏图标不会“自动出现”,装完插件或换主题后没图标,大概率是三处配置没对齐:插件启用、主题支持、设置项位置正确。单独做任何一步都无效。
为什么 A File Icon 装了却没图标?
它不画图,只发指令;真正渲染图标的是当前 .sublime-theme 文件。常见失效链:
-
"file_icons": true写在了"theme"对象里(比如嵌套在{"theme": {"file_icons": true}}),Sublime 直接忽略 - 用了
Material Theme却没加"file_icons_material_theme": true - 主题被
ignored_packages列表禁用(检查 Settings – User 里是否有"ignored_packages": ["Material Theme"]) - 执行过
A File Icon: Rebuild Icons但没重启 Sublime Text(缓存重建后需重启才加载新映射)
如何让 .env、.toml 这类文件显示图标?
它们不在 A File Icon 默认映射表里,必须手动绑定内置图标名:
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加
"file_icons"块,值必须是 A File Icon 内置的图标标识符(不是文件名,也不是随便写的字符串) - 示例:
{ "file_icons": { ".env": "dotfile", ".toml": "config", ".yml": "config" } } - 保存后图标通常秒变;若不生效,再执行一次
A File Icon: Rebuild Icons
想改文件夹图标颜色或样式?先确认主题是否支持 colored_folders
默认情况下,A File Icon 不处理文件夹图标——它只管文件。要让文件夹也带色,得两头配合:
- 在
A File Icon的 Settings – User 中启用:{"colored_folders": true, "folder_animation": false} - 当前主题必须定义了
"class": "folder_icon"规则(Material Theme、ayu-dark支持;Seti_UI、Origami多数不支持) - 如果用了
Material Theme,还需额外加"material_theme_big_fileicons": true,否则彩色文件夹逻辑不触发 - Windows 下若 Sublime 安装在 OneDrive 同步目录,
Packages/A File Icon/icons/权限异常会导致 SVG 加载失败,图标变灰或缺失
直接改 .sublime-theme 文件时最容易翻车的三个点
主题文件是 JSON 数组,每条规则匹配一个 UI 元素。改错一个字段,整块侧边栏可能空白或错位:
-
layer0.texture必须指向有效的 PNG 路径(如"Theme - Default/folder.png"),不能写绝对路径、web URL 或 SVG —— Sublime 渲染时只认 PNG 回退路径 -
layer0.tint是 RGB 三元整数数组(如[40, 40, 40]),不是#3a405a或rgb();它同时影响图标和文字色调,想保图标原色就得调成接近图标的 RGB 值 - 改之前务必用
PackageResourceViewer提取主题源码并另存到Packages/User/目录下,别硬改Packages/Theme - Default/里的原始文件——升级会被覆盖,且语法错误会崩 UI
真正难的不是改哪一行,而是搞清哪一层在控制什么:插件只发信号,主题负责渲染,配色方案管文字颜色,三者稍有错位,图标就消失或发灰。动手前先看一眼当前主题名、确认 file_icons 在顶层、再查插件文档里支持的图标名列表——比反复重启试错快得多。











