A File Icon 插件需 Sublime Text 4.4192+、启用 "file_icons": true（顶层JSON）、未被 ignored_packages 屏蔽、配合支持 file_icon 的主题（如 Adaptive），并为冷门后缀在插件设置中正确映射带点扩展名与内置图标名，且修改后必须重启编辑器。
Sublime Text 4.4192+ 是硬门槛
低于这个版本的 Sublime Text，A File Icon 插件会静默失效——不报错、不提示、图标就是不出现。打开 Help → About Sublime Text，右下角版本号必须是 4.4192 或更高。旧版别折腾配置，直接去官网下载最新 ST4 安装包覆盖安装，装完必须彻底退出再重开。
“file_icons”: true 必须写在 Settings – User 顶层
这个开关不是可选项，而是启动图标的总闸门。它必须出现在 Preferences → Settings – User 的 JSON 根层级，不能嵌套在 "theme_settings"、"ui_theme" 或任何其他对象里。拼写也必须严格匹配：file_icons（不是 file_icon、file_icons_enabled 或 enable_file_icons）。
同时确认 "ignored_packages" 列表里没把 "A File Icon" 放进去——哪怕只有一行，插件就被禁用。
主题不支持 = 白搭配置
图标最终能不能画出来，取决于当前 UI 主题是否定义了 class: "file_icon" 及其子类（如 icon-js、icon-config）。Default.sublime-theme、Slush & Poppies、Origami 这些主题压根没预留图标占位区，配得再对也没用。
- 最省心方案：切到 Sublime 自带的
Adaptive.sublime-theme（菜单 →Preferences → Theme） - 如果用
Material Theme，必须在Settings – User中加"material_theme_file_icons": true，否则它会主动屏蔽外部图标注入 - 别手动编辑
Packages/Theme - Default/Default.sublime-theme—— 升级后会被覆盖
.env、.toml 这类冷门后缀要手动映射
A File Icon 默认只识别约 200 种扩展名，.env、.toml、.astro 等不会自动匹配。解决方式是修改 Preferences → Package Settings → A File Icon → Settings – User，添加 "extensions" 映射：
{
"extensions": {
".env": "settings",
".toml": "config",
".astro": "html"
}
}
注意两点：
- 键名必须带点（
".env"），不是"env"；早期文档说小写无点是错的，当前最新版（2026 年）已统一为带点格式 - 值必须是插件内置图标名（查
Default Settings里的icon_names字段），写成"dot_env"或"myconfig"就 fallback 成空白文档图标，且不报错
改完保存后，必须重启 Sublime Text —— A File Icon: Rebuild Icon Cache 命令对新 extensions 映射无效。
复杂点在于：图标显示是插件注入 class + 主题渲染资源的链式依赖，任一环节断开，就只剩文件名。很多人卡在“以为配对了”，其实是主题没切对，或版本太低，或映射格式过时。
