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 在顶层、再查插件文档里支持的图标名列表——比反复重启试错快得多。
