A File Icon 是 Sublime Text 最稳定免依赖的文件图标插件，推荐通过 Package Control 安装；手动安装需确保路径正确、解压内容至 A File Icon/ 子目录并重启；图标不显示需检查启用状态、插件冲突及扩展名映射；颜色过淡可通过 Customize Theme 调整 layer0.tint 和 opacity。
Sublime Text 默认侧边栏不显示文件类型图标，A File Icon 是目前最稳定、兼容性最好、无需额外依赖的图标插件——它直接替换 Sublime 原生图标资源，不依赖 Theme 或 Color Scheme，安装后开箱即用。
通过 Package Control 安装（推荐）
这是最安全、可自动更新的方式。确保你已安装 Package Control（没装请先搜索 “Install Package Control” 官方文档）：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Package Control: Install Package并回车 - 等待列表加载完成，再输入
A File Icon，选中后回车 - 安装完成后无需重启，图标会立即出现在侧边栏文件/文件夹旁
手动安装失败的常见原因
手动解压到 Packages 目录容易出错，尤其在 macOS 或启用 SIP 的系统上：
-
Packages路径必须准确：Windows 是%APPDATA%\Sublime Text\Packages\，macOS 是~/Library/Application Support/Sublime Text/Packages/ - 不能把整个 ZIP 解压成
A File Icon-master/文件夹，必须把内容解压进A File Icon/子目录（即最终路径为Packages/A File Icon/） - 如果已有同名文件夹（比如旧版残留），先删除再安装，否则图标可能不生效
- 手动安装后需重启 Sublime，且首次加载可能延迟 1–2 秒
图标不显示？检查这三件事
不是所有文件都默认显示图标，A File Icon 的行为受以下设置控制：
- 确认插件已启用：菜单栏
Preferences → Package Settings → A File Icon → Settings中，"enabled"必须为true - 检查是否被其他插件覆盖：如
Origami、SideBarEnhancements等老版本可能干扰图标渲染，临时禁用它们测试 - 某些文件扩展名未内置支持（例如
.env、.yml），可在用户设置中添加映射：{ "file_icons": { ".env": "dotfile", ".yml": "yaml" } }
图标颜色与主题冲突怎么办
A File Icon 默认使用灰阶图标，适配绝大多数主题；但如果你用的是高对比度深色主题（如 Dracula 或 Nord），可能觉得图标太淡：
- 不建议改图标源文件（升级会丢失），而是通过主题配置微调：在
Preferences → Theme → Customize Theme中添加规则 - 例如增强图标饱和度：
{ "rules": [ { "class": "icon_file_type", "layer0.opacity": 1.0, "layer0.tint": [200, 200, 200] } ] } - 注意：
layer0.tint值是 RGB 数组，[255, 255, 255]是白色，[0, 0, 0]是黑色；过度调亮可能导致图标边缘发虚
真正要注意的其实是图标缓存机制：Sublime 不会实时重绘所有图标，新增文件或改扩展名后，有时要折叠再展开父文件夹才刷新。这个细节没人提，但每天都会遇到两次。
