a file icon 图标显示需插件、主题、配置三者严格匹配：认准 sublimelsp 版本并重启；用户设置顶层写"file_icons": true；选用 material-theme 等支持图标渲染的主题。
图标主题不会自动开启，必须同时满足插件、主题、配置三者匹配，缺一不可。
确认 A File Icon 插件装对了（别被同名包骗了）
Package Control 搜索 A File Icon 会列出多个作者版本，只有 sublimelsp 维护的才是 ST4 兼容版。其他分支（如 kkga 或 braver）在 2026 年已出现图标规则缺失、冷门后缀不识别等问题。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Package Control: Install Package→ 回车 → 手动输入A File Icon - 下拉列表中核对作者字段是否为
sublimelsp，不是就跳过 - 安装后必须关闭并重新打开 Sublime Text —— 图标只在启动时加载
.sublime-theme文件
检查 UI 主题是否支持图标渲染
默认的 Default.sublime-theme 和 Adaptive.sublime-theme 不含图标绘制规则，即使插件和配置都对，图标区也留白或显示问号。
- 推荐直接使用原生支持图标的主题：
Material-Theme.sublime-theme、ayu-dark.sublime-theme、Theme - Soda - 切换方式：
Ctrl+Shift+P→ 输入UI: Select Theme→ 选带.sublime-theme后缀的项 - 部分主题需额外启用开关：例如
Material Theme要在Settings – User中加"material_theme_small_file_icons": true
配置文件里必须写对这三项硬性字段
图标是否显示，取决于 Settings – User JSON 的顶层是否同时存在且拼写完全正确的三个字段：
-
"theme"：值必须是完整文件名，含大小写、连字符、后缀，例如"Material-Theme.sublime-theme"（不是"Material Theme"） -
"icon_theme"：值必须与已安装插件名完全一致，例如"A File Icon"（大小写敏感，不能是"a file icon"） -
"file_icons"：必须是布尔值true，且位于 JSON 顶层，不能嵌套在"theme"或其他对象里；写成"file_icons": "true"或"file_icon": true都无效
另外注意：file_exclude_patterns 或 folder_exclude_patterns 若误加了 "*.md" 这类通配符，A File Icon 会跳过对应路径，图标也不渲染。
最常被忽略的是：ST4 要求 Sublime Text 版本 ≥ 4.4192 才能启用图标逻辑 —— 低于该版本会静默失效，不报错也不提示。检查方式：菜单栏 Help → About Sublime Text，右下角看版本号。升级后务必重启，否则插件加载链不触发。
