Sublime Text 不支持第三方图标主题，图标美化依赖 A File Icon 插件与兼容 UI 主题协同实现，所有图标源自 Octicons 字体；图标不显示主因是未同时满足插件启用、主题支持及用户设置中顶层配置 "file_icons": true。
Sublime Text 本身不支持“第三方图标主题”这个概念——它没有图标主题 marketplace，也不加载 PNG/SVG 图标包。所谓“图标美化”，实际是 A File Icon 插件 + 兼容的 UI 主题（如 Adaptive、Material Theme）协同工作的结果，所有图标都来自内置的 Octicons 字体，不是图片资源。
为什么装了 A File Icon 还没图标
图标不显示，90% 是因为三个条件没同时满足：
-
A File Icon已安装且未被禁用（检查Preferences → Package Settings → A File Icon → Settings能否打开） - 当前 UI 主题支持图标渲染：
Default.sublime-theme和Slush & Poppies默认关闭；Adaptive自带但需显式启用；Material Theme需手动加"file_icons": true -
"file_icons": true必须出现在Preferences → Settings – User的顶层 JSON 中，不能嵌套在"theme"或其他对象里 - 别漏掉系统适配开关：macOS 用户建议加
"file_icons_osx": true，Windows 加"file_icons_win": true，Linux 加"file_icons_linux": true
临时验证方法：菜单栏 → Preferences → Theme → Adaptive.sublime-theme，切过去后图标若出现，说明你当前主题不兼容或配置缺失。
Material Theme 下图标不显示的硬性条件
Material Theme 自带图标逻辑，但默认不强制启用，且容易和旧插件冲突：
- 必须确保
"file_icons": true明确写在用户设置中（ST4 强制要求） - 不能同时启用
FileIcons插件——它和A File Icon的图标注入机制会互相覆盖，导致侧边栏空白或错位 - 检查
ignored_packages列表，确认没把Material Theme加进去（路径大小写敏感，错一个字母就失效） - 别加已废弃的配置项，比如
"material_theme_background_panel": true（v5.0+ 已移除，加了反而报错）
自定义扩展名图标映射（如 .astro、.svelte）
新扩展名默认无图标，显示为通用文档图标。补映射必须走用户配置，不能改插件源码（否则升级即丢）：
- 菜单栏 →
Preferences → Package Settings → A File Icon → Settings – User - 添加映射规则，例如：
"icon_file_extensions": {"astro": "html", "svelte": "html", "env": "settings"} - 值必须是插件已支持的图标名（
js、css、folder、settings等），不能随便写astro或svelte - 保存后图标自动刷新；若没变，右键侧边栏 →
Refresh Folders，或关闭再打开项目
高分屏下图标模糊或缩放异常
这是 DPI 缩放与字体图标尺寸不匹配导致的，尤其在 macOS Retina 或 Windows 150% 缩放时明显：
- 不要手动在设置里加
"dpi_scale"或修改font_size强行缩放——这会让图标边缘锯齿、文字错位 - 正确做法是确保系统级缩放设置合理，并使用最新版
A File Icon（2026 年 4 月版本已优化高分屏 fallback 渲染） - 如果仍模糊，可临时切换到
Adaptive主题测试：它对 Octicons 字体的渲染控制更稳定，能快速判断是否为当前主题的 icon set 实现问题
最常被忽略的一点：图标是否显示，根本不在“插件装没装”，而在“主题认不认识图标数据”。哪怕插件全开，只要 theme 文件里没声明 icon_set 支持，或者 "file_icons": true 被套进了某个对象里，图标就永远是空的。
