Sublime Text 的图标功能依赖 A File Icon 插件与支持图标的 UI 主题协同实现，图标源自 Octicons 字体而非图片；需先确保 Package Control 正常安装并可用，再安装 A File Icon，并在 Settings – User 中启用 "file_icons": true，同时确认当前主题支持图标渲染；冷门扩展名需手动映射至内置图标名；图标颜色可通过 Customize Theme 微调；图标仅显示于侧边栏，不影响标签页或系统图标。
Sublime Text 本身不支持“安装图标包”这个概念——它没有像 VS Code 那样的图标主题 marketplace，也没有内置的 PNG/SVG 图标加载机制。所谓“自定义图标”，实际是通过 A File Icon 插件 + 支持图标的 UI 主题协同实现的，所有图标都来自字体（Octicons），不是图片资源。
确认 Package Control 已就位，否则一切免谈
几乎所有失败都卡在这一步：命令面板调不出来、Package Control: Install Package 无响应、或提示 “There are no packages available”。这不是插件问题，而是网络或安装损坏：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）必须能弹出命令面板；不能，说明Package Control没装好或被防火墙拦截 - 若已安装但列表为空，大概率是系统代理/杀毒软件/公司网络屏蔽了
packagecontrol.io域名 - 别跳过验证：打开
Preferences → Package Settings，看有没有Package Control项；没有就重装——去官网复制对应系统的安装代码，粘贴进View → Show Console执行
安装 A File Icon，但别指望“装完就亮”
A File Icon 是唯一稳定适配 Sublime 4 的侧边栏图标方案，但它不等于“图标包”，它只是向 sidebar 注入图标数据的桥梁。图标是否显示，取决于三件事是否同时满足：
- 插件已安装且启用（检查
Preferences → Package Settings → A File Icon → Settings是否可打开） - 当前 UI 主题支持图标渲染（
Default.sublime-theme和Slush & Poppies默认关闭图标；Adaptive自带但需手动开启） -
"file_icons": true必须出现在Preferences → Settings – User的顶层 JSON 中，不能嵌套在"theme"或其他对象里
常见错误：用户设置了 "file_icons": false 却忘了删，或者用的是第三方主题（如 Material Theme）却没查文档是否需加 "file_icons_material_theme": true。
让 .env、.toml 这类冷门后缀也显示图标
A File Icon 内置覆盖约 200 种扩展名（.js、.py、.md 等），但对 .env、.conf、.yml 等默认不识别。这时要手动映射，而不是换图标包：
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加
"file_extensions"块（注意不是"file_icons"）：
{
"file_extensions": {
"env": "flask",
"conf": "gear",
"toml": "config"
}
}
右值（如 "flask"）必须是插件内置图标名，完整列表见其 GitHub README 的 icon names 表格；左值是小写、无点的扩展名（"env" 对应 .env 文件）。不支持通配符，也不支持按文件内容判断类型。
图标颜色太淡？别改字体文件，用 Customize Theme 微调
深色主题（如 Dracula、Nord）下图标常显得灰白模糊，这不是插件 bug，而是字体图标的默认 tint 和 opacity 值偏低。强行替换 Octicons.ttf 或改源码会升级丢失：
- 打开
Preferences → Theme → Customize Theme - 添加 layer 覆盖规则，例如增强饱和度和对比度：
{
"rules": [
{
"class": "icon_file",
"layer0.tint": [200, 200, 220],
"layer0.opacity": 0.9
}
]
}
这个配置只影响图标渲染层，不影响语法高亮或 UI 其他部分，安全且可逆。
真正容易被忽略的点是：图标只存在于侧边栏，不会出现在标签页、状态栏或系统级快捷方式上；想换程序图标（比如任务栏那个 Sublime 小方块），那是操作系统层面的资源替换，和 A File Icon 完全无关。
