Material Icon 必须配合 Material Theme 使用，单独安装图标插件无效；需启用正确主题、设置"file_icons": true、禁用冲突插件并重启。
Material Icon 不是独立主题，它必须配合 Material Theme 使用
单独安装 A File Icon 或 Material Theme Icons 不会改变侧边栏图标样式——Sublime 的图标渲染由 UI 主题控制，不是图标插件自己决定的。Material Theme 自带图标逻辑（v5.0+），A File Icon 是兼容方案，Material Theme Icons 是官方配套，但两者都不能脱离 theme 字段生效。
常见错误现象：
装了 A File Icon 但侧边栏仍是文字 + 默认方块；
装了 Material Theme Icons 却提示 “no icon found”；
重启后图标忽有忽无。
- 必须先启用
Material-Theme-Darker.sublime-theme（或其他带.sublime-theme后缀的 Material 主题文件） - 在用户设置中显式开启图标开关：
"file_icons": true（Sublime Text 4 必须写，ST3 可省略） - 不要同时启用
A File Icon和Material Theme Icons—— 它们注册的图标 provider 冲突，后者优先级更高但可能被前者覆盖 - 如果用了
ignored_packages，确认没把Material Theme或Material Theme Icons列进去
配置 file_icons 开关和主题路径必须严格匹配
file_icons 是 Material Theme 的内置开关，不是插件名，也不区分大小写，但它只在 theme 正确加载后才起作用。一旦 theme 路径错一个字符（比如少个 -、多一个空格、后缀写成 .sublime-them），整个 UI 包括图标都会静默回退到默认状态，且不报错。
实操建议：
打开命令面板 → 输入 UI: Select Theme → 找到带 ✔️ 的当前主题名（例如 Material-Theme-Darker.sublime-theme）
复制该名称，粘贴到 Settings – User 中作为 "theme" 值
再加一行："file_icons": true
- 别写
"file_icons": "true"（字符串无效）或"file_icons": 1（非布尔值） - 别在
Settings – Default里改——升级后会被覆盖 - 路径中所有空格、连字符、大小写都必须与
UI: Select Theme显示的一致；Windows 下也用正斜杠/，不是反斜杠\
图标不显示？先关掉冲突插件再排查
最常导致图标空白的原因不是配置错，而是其他插件劫持了图标渲染链。特别是旧版 FileIcons、Theme - Soda、Seti_UI 这类老牌主题，它们会覆盖 file_icons 的 provider 注册，让 Material 的图标逻辑完全失效。
排查步骤：
Preferences → Package Settings → Package Control → Settings – User
检查 "ignored_packages" 是否包含 "FileIcons" 或 "Theme - Soda"
如果没有，临时禁用这些插件：菜单 → Preferences → Package Control → Disable Package
- 禁用后重启 Sublime，再试图标是否出现
- 确认
Material Theme Icons已安装（命令面板搜Install Package→Material Theme Icons） - 如果仍无图标，检查是否误启用了
"material_theme_small_tab_bar": true等实验性开关——某些 v6.x 版本下它会干扰图标渲染
高 DPI 屏幕下图标模糊或发虚
Material Theme 在 Windows 高分屏 + ST4 组合下，默认启用 subpixel_antialias，会导致图标边缘泛白、锯齿感强，尤其小尺寸图标（如 .js、.py）几乎不可辨。
解决方法不是换字体，而是调整抗锯齿策略：
在 Settings – User 中添加："font_options": ["gray_antialias"]
这个选项强制使用灰阶抗锯齿，对图标清晰度提升明显，且不影响文字可读性。
- 别加
"font_options": ["subpixel_antialias", "gray_antialias"]—— 二者互斥，后者会被忽略 - macOS 用户若启用了
hidpi_scale_factor，需同步设"material_theme_bold_tab_font": true，否则标签页图标文字过细 - 改完必须重启 Sublime；热重载对图标资源加载无效
配置生效依赖完整链路：Package Control 正常 → Material Theme 安装并激活 → theme 路径精确 → file_icons 开关为布尔 true → 无冲突插件 → 重启。漏掉任意一环，图标就停在“应该有但没有”的状态。
