Sublime Text 文件图标不显示，主因是 theme、icon_theme、file_icons 三者未对齐或插件安装错误；必须安装 sublimelsp 版 A File Icon，配对设置 theme 和 icon_theme，手动添加冷门后缀映射并重建缓存。
Sublime Text 文件图标不显示，90% 是因为 theme、icon_theme、file_icons 三者没对齐，或者压根没装对插件——它不会报错，只会安静地留白。
确认 A File Icon 插件是否真装对了
Package Control 搜 “A File Icon” 会列出多个同名包，但只有作者是 sublimelsp 的那个才兼容 ST4 且规则完整。kkga、braver 等分支在 2026 年已停止维护，常见症状包括：.env、.yml、.toml 图标缺失，或 AFileIcon: Rebuild Icon Cache 命令根本不出现在命令面板里。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package - 等列表加载完，**手动输入
A File Icon并回车**，在下拉项中核对作者字段是否为sublimelsp - 装完必须重启 Sublime Text ——
.sublime-theme文件只在启动时读取一次 - 若已装错，先执行
Package Control: Remove Package卸载，再重装
主题（theme）和图标主题（icon_theme）必须同时配对
只改 theme 或只改 icon_theme 都不行。Sublime 不会自动关联二者，也不会提示你漏了哪项。
- 编辑
Preferences → Settings – User，确保 JSON 顶层有这两行（注意大小写、连字符、后缀）： "theme": "Material-Theme.sublime-theme""icon_theme": "A File Icon"- 常见错误：
"theme": "Material Theme"（缺连字符和.sublime-theme）、"icon_theme": "a file icon"（大小写错）、"file_icons": true写在"theme"对象内部（必须是顶层键） - 如果用的是
ayu-dark.sublime-theme，icon_theme仍填"A File Icon"，不是"ayu"—— 图标逻辑由插件提供，主题只负责渲染
文件夹图标和文件图标是两套机制
"file_icons": true 只控制文件后缀图标（如 .py 右侧小图标），对文件夹图标完全无效。文件夹图标由主题里的 "class": "icon_folder" 规则决定，和 A File Icon 插件无关。
- 默认的
Default.sublime-theme和Adaptive.sublime-theme都不含icon_folder定义，所以即使其他全对，文件夹也空白 - Material-Theme、ayu-dark、Theme - Soda 这些第三方主题才内置了文件夹图标规则
- 某些主题（如 Material Theme）需额外开启：
"material_theme_small_file_icons": true，否则文件夹图标可能被压缩成单像素点 - 别去硬改
Packages/Theme - Default/Default.sublime-theme—— 升级就覆盖；要用PackageResourceViewer提取后另存为自定义主题
.env、.yml 等冷门后缀图标怎么加
A File Icon 默认只映射主流后缀。像 .env、.yml、.tsx 这类，需要手动补映射规则，否则永远显示默认文档图标。
- 打开
Preferences → Package Settings → A File Icon → Settings - 在右侧用户设置中添加
file_extensions字段，例如： "file_extensions": {"env": "settings", "yml": "yaml", "tsx": "typescript"}- 值对应的是图标标识符（不是文件类型名），可查官方文档或直接看
Packages/A File Icon/icons/下的 SVG 文件名前缀 - 改完不用重启，但需运行
AFileIcon: Rebuild Icon Cache命令刷新缓存
最容易被忽略的一点：项目级设置（.sublime-project）会覆盖全局设置。如果你在项目里写了 "theme" 或删了 "file_icons"，侧边栏图标就会突然消失——检查项目设置比重装插件更快。
