A File Icon 图标显示需同时满足插件(sublimelsp版)、主题(如Material-Theme.sublime-theme)及配置(file_icons: true、theme、icon_theme三项齐全)三条件,缺一不可。

Sublime Text 默认不显示文件图标,装插件 ≠ 图标自动出现——必须同时满足插件、主题、配置三项硬性条件,缺一不可。
怎么确认 A File Icon 装对了(别被同名包坑)
A File Icon 在 Package Control 里有多个作者版本,只有 sublimelsp 维护的才是 ST4 官方适配版。kkga、braver 等分支在 2026 年已停止同步图标规则,常见表现为:.env、.toml、.yaml 不显示图标,或图标区域全为空白/问号。
- 打开命令面板(
Ctrl+Shift+P/Cmd+Shift+P),输入Package Control: Install Package - 等列表加载完后,**手动输入
A File Icon并回车**(别点搜索结果里的“FileIcons”或“AFileIcon”) - 安装完成后,检查
Preferences → Package Settings → A File Icon → Settings是否能打开;打不开说明没装对 - 已装错?先执行
Package Control: Remove Package卸载,再重装
为什么图标还是不显示(三个必查硬编码项)
图标是否渲染,只取决于用户设置(Preferences → Settings – User)里这三项是否同时成立:
-
"file_icons": true必须是顶层键,不能嵌在"theme"或其他对象里;写成"file_icons": "true"(字符串)、"file_icon": true(拼写错误)、或漏掉都无效 -
"theme"值必须是带.sublime-theme后缀的完整文件名,例如"Material-Theme.sublime-theme";"Material Theme"或"material-theme"都不认 -
"icon_theme"字段不是可选的:用 Material Theme 就得配"icon_theme": "A File Icon";只配theme不配icon_theme,UI 会变但图标仍空白
临时验证法:把 theme 改成 "Adaptive.sublime-theme"(ST4 自带),再运行命令 AFileIcon: Rebuild Icon Cache,比重启更快见效。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
哪些主题真能画出图标(Default 和 Adaptive 别乱试)
A File Icon 插件本身不提供任何图标图形,它只负责告诉 Sublime “这个 .py 文件该用哪个 class 渲染”。真正画图标的,是当前 UI 主题里的 .sublime-theme 文件。
-
Default.sublime-theme和Adaptive.sublime-theme(哪怕名字带 “Adaptive”)默认都不含图标规则,所以即使插件和开关都对,图标区也留白 - 推荐直接换主题:
Material-Theme.sublime-theme、ayu-dark.sublime-theme、Theme - Soda均原生支持图标渲染 - 部分主题需额外开启开关:比如 Material Theme 要加
"material_theme_small_file_icons": true才显示小尺寸图标 - 别搜
"sidebar_icons"这种键——Sublime 没这个配置项,所有相关搜索都是误导
怎么让 .env、.toml 这类冷门后缀显示图标
A File Icon 默认只映射常见后缀(.js、.py、package.json 等)。像 .env、.toml、.webp 这类,需手动映射到它内置的图标名上,且主题必须支持对应 class 渲染。
- 在
Preferences → Package Settings → A File Icon → Settings中添加:
{
"file_extensions": {
".env": "dotfile",
".toml": "config",
".webp": "image"
}
}
A File Icon 文档中的 icon names 列表,如 dotfile、config、image、script 等dotfile 或 config 对应的 class 规则——换主题或手动编辑 .sublime-theme 文件文件夹图标是另一套机制,和 file_icons 开关无关,由主题中 "class": "icon_folder" 规则决定;默认主题全都不支持,必须换主题或手改 .sublime-theme。










