图标不显示需三步：装sublimelsp版A File Icon并重启；file_icons布尔开关置于用户设置顶层；启用支持图标的UI主题如Material-Theme。
图标不显示？先确认 A File Icon 装对了
Package Control 搜索 A File Icon 会列出多个同名包，但只有作者是 sublimelsp 的那个才兼容 Sublime Text 4。其他分支（如 kkga、braver）在 ST4 下常出现图标缺失、冷门后缀不识别、或与 file_icons 配置冲突的问题。
实操建议：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Package Control: Install Package→ 回车 → 等列表加载完 → 手动输入A File Icon并回车 - 在下拉项中核对作者字段是否为
sublimelsp - 装完必须重启 Sublime Text —— 图标规则只在启动时加载，不重启侧边栏永远空白或显示问号
必须配 file_icons 开关，且位置不能错
file_icons 是一个布尔开关，不是字符串，也不是嵌套在其他对象里的配置项。它必须出现在用户设置（Preferences → Settings – User）的 JSON 顶层，否则 Sublime 完全忽略。
常见错误现象：
- 写成
"file_icons": "true"（字符串）→ 无效 - 漏掉该字段，或拼成
file_icon→ 图标不渲染 - 把它塞进
"theme"对象里，例如："theme": { "file_icons": true, ... }→ 不生效 - 项目级设置（
.sublime-project）覆盖了全局设置 → 检查项目文件是否误写了"file_icons": false
UI 主题得真正支持图标绘制
A File Icon 只负责提供图标映射逻辑，不画图；真正负责渲染图标的，是当前启用的 .sublime-theme 文件。默认的 Default.sublime-theme 和 Adaptive.sublime-theme 都不含图标规则，所以即使插件和开关都对，图标区也留白。
推荐直接换用原生支持图标的主题：
-
Material-Theme.sublime-theme（需额外加"material_theme_small_file_icons": true） -
ayu-dark.sublime-theme或ayu-light.sublime-theme -
Theme - Soda（注意：需手动下载配套 color scheme）
别指望 Preferences → Settings 里有 sidebar_icons 这种键——Sublime 没这个配置项。
路径和大小写一个字符都不能错
主题和图标配置依赖精确的文件名匹配。ST4 对大小写、空格、连字符、后缀都敏感，错一个就退回到默认样式，且不报错。
正确示例（以 Material Theme + A File Icon 组合为例）：
{
"theme": "Material-Theme.sublime-theme",
"icon_theme": "A File Icon",
"file_icons": true
}
典型错误：
-
"theme": "Material Theme"→ 少连字符、少.sublime-theme后缀 -
"icon_theme": "a file icon"→ 大小写错误，必须是"A File Icon" -
"theme": "material-theme.sublime-theme"→ 首字母小写，文件系统里实际是大写 M
最稳做法：安装完主题后，运行一次对应命令（如 Material Theme: Activate theme），它会自动填入完全匹配的路径，比手敲可靠得多。
