A File Icon 图标不显示的首要原因是插件未正确安装或配置；需确认安装 sublimelsp 版本、重启编辑器、在用户设置顶层启用 "file_icons": true、换用支持图标的主题并正确配置 theme 和 icon_theme 字段。
确认 A File Icon 插件已正确安装
图标不显示，第一排查点永远是插件本身有没有装对。Package Control 搜索 A File Icon 会列出多个同名包，但只有作者为 sublimelsp 的版本在 ST4 下稳定支持图标映射和冷门后缀识别。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package - 等列表加载完成，**手动输入
A File Icon并回车**，在下拉项中核对作者字段是否为sublimelsp - 装完必须重启 Sublime Text —— 图标资源只在启动时加载，不重启侧边栏永远空白或显示问号
- 如果已装错，先执行
Package Control: Remove Package卸载，再重装
启用 file_icons 开关且位置不能错
这个布尔值开关是图标渲染的硬性前提，但它必须出现在用户设置（Preferences → Settings – User）的 JSON 顶层，不能嵌套在 "theme" 或其他对象里，也不能写成字符串 "true"。
- 打开
Preferences → Settings – User，确保有这一行："file_icons": true - 拼错成
file_icon、漏掉、写成"file_icons": "true"都无效 - 检查
Preferences → Settings – Default里没有同名项覆盖；也检查当前项目（.sublime-project）是否误写了"file_icons": false - 临时验证：切回
Adaptive.sublime-theme，再运行命令AFileIcon: Rebuild Icon Cache，比重启更快见效
换用真正支持图标的 UI 主题
A File Icon 只提供图标映射逻辑，不负责绘制；真正画出图标的，是当前 UI 主题里的 .sublime-theme 文件。默认的 Default.sublime-theme 和 Adaptive.sublime-theme 都不含图标规则，所以即使插件和开关都对，图标区依然留白。
- 推荐直接换主题：
Material-Theme.sublime-theme、ayu-dark.sublime-theme、Theme - Soda - 安装后必须在
Settings – User中配置："theme": "Material-Theme.sublime-theme"（注意后缀和连字符） - 部分主题需额外开启图标支持，比如 Material Theme 要加：
"material_theme_small_file_icons": true - 别信“主题自带图标”这种模糊说法——必须确认该主题的 GitHub 页面或文档明确写了 “supports file icons” 或包含
icon相关 rule 定义
别忽略 icon_theme 字段的协同作用
很多现代主题（如 Material Theme）要求同时配置 icon_theme，否则图标区域可能显示异常或缺失部分类型。
- 在
Settings – User中，"theme"和"icon_theme"必须同时存在，缺一不可 - 值必须与已安装包名称完全一致：例如
"icon_theme": "A File Icon"（大小写、空格、连字符全敏感） - 写成
"A file icon"或"a file icon"都会导致图标不加载 - 如果用了
Material Theme，它自带图标集，此时"icon_theme"可省略；但若搭配A File Icon使用，则必须显式指定
Sublime 的图标系统不是开箱即用的开关，而是插件、主题、配置三者咬合的机械结构——任一环节错位，图标就停摆。最容易被忽略的是：主题文件名拼写错误、file_icons 不在顶层、以及重启被跳过。
