Sublime Text 文件图标不显示需同时满足：ST版本≥4.4192、Settings–User中启用"file_icons":true、禁用ignored_packages中的A File Icon、选用支持图标的主题（如Adaptive）、正确配置extensions映射并重启。
Sublime Text 侧边栏里文件类型图标不显示，或者 .env、.toml 这类文件没图标，不是插件没装好，而是 A File Icon 和主题没对齐——缺一不可。
确认 A File Icon 是否真正生效
A File Icon 在 Sublime Text 4.4192 以下版本会静默失效，不报错也不显示图标。打开 Help → About Sublime Text，右下角版本号必须 ≥ 4.4192。低于这个版本，覆盖安装最新 ST4 安装包即可。
还要检查 Settings – User 里有没有这行：
{
"file_icons": true
}注意：file_icons 必须写在 JSON 顶层，不能嵌套在 "theme_settings" 或其他对象里；拼写也不能错（比如 file_icon 或 file_icons_enabled 都无效）。
常见干扰项：
-
"ignored_packages": ["A File Icon"]还留在设置里 → 插件被禁用 - 当前
"theme"是"Default.sublime-theme"→ 默认主题不预留图标占位区 - 用了 Material Theme 却没开
"material_theme_file_icons": true→ 主题主动屏蔽插件图标
让 .env、.toml 等冷门后缀显示图标
A File Icon 默认只识别约 200 种扩展名，.env、.prettierrc、.astro 这些不会自动匹配图标。解决方式是手动映射到它内置的图标标识符上，不是随便起名。
打开 Preferences → Package Settings → A File Icon → Settings – User，添加：
{ "extensions": { ".env": "settings", ".toml": "config", ".astro": "html" } }其中 "settings"、"config" 是插件内置的图标名（见其 Default Settings 的 icon_names 字段），不能写成 "dot_env" 这种自定义字符串。
保存后必须重启 Sublime Text —— A File Icon: Rebuild Icon Cache 命令不加载新 extensions 映射。
主题必须支持图标渲染
文件图标能否显示，最终取决于当前 UI 主题是否定义了 "class": "file_icon" 及对应图层规则。Default、Slush & Poppies、Origami 等主题默认不支持，改设置也没用。
推荐方案：
- 用 Sublime 自带的
Adaptive.sublime-theme（最轻量稳定） - 或第三方主题如
Material-Theme.sublime-theme，但要确保用户设置里有"material_theme_file_icons": true - 切忌直接编辑
Packages/Theme - Default/Default.sublime-theme—— 升级后会被覆盖
切换主题后务必重启，仅 UI: Reload Theme 不刷新图标缓存。
图标显示但颜色/大小异常？检查主题与插件的协作细节
Material Theme 等第三方主题常自带图标逻辑，可能覆盖 A File Icon 的配置。例如它把 .ts 强制映射为 JS 图标，你再在 A File Icon 里配 "extensions": {".ts": "typescript"} 也无效。
调试建议：
- 临时切换回
Adaptive.sublime-theme+"file_icons": true，验证基础图标是否正常 - 确认
A File Icon的icon_file_extensions（旧版字段）和extensions（新版字段）没同时存在，后者优先 - 某些主题（如 Seti_UI）依赖
"colored_folders": true开关才能激活文件图标色系，这个字段要写在 Settings – User 顶层
最易忽略的一点：项目级 .sublime-project 文件里的 "settings" 会覆盖全局设置，导致图标开关失效——检查右下角状态栏是否显示「Project Settings」字样。
