图标不显示需同时满足：A File Icon 已启用、主题支持图标（如 Adaptive 或 Material Theme）、用户设置中顶层配置 "file_icons": true；.env 等文件需手动映射扩展名；文件夹图标需开启 "colored_folders": true 并关闭动画；图标错位多因主题与字号不匹配。
图标不显示？先确认 A File Icon 和主题是否真正协同工作
装完 A File Icon 没图标，90% 不是插件问题，而是它和当前 UI 主题没对上。Sublime 的图标渲染完全依赖主题文件（.sublime-theme）里是否定义了图标规则，A File Icon 自己只提供数据，不画图。
必须同时满足三件事：
-
A File Icon已安装且启用（Preferences → Package Settings → A File Icon → Settings 能打开） - 当前启用的主题明确支持图标，比如
Adaptive.sublime-theme（Sublime 4 自带）、Material-Theme.sublime-theme或AFileIcon Dark.sublime-theme - 用户设置（Preferences → Settings – User）顶层有
"file_icons": true，不能嵌套在"theme"或其他对象里，也不能拼错成"file_icon"
常见坑：用 Default.sublime-theme 或 Slush & Poppies 时图标必然不显示；用 Material Theme 却没加 "file_icons_material_theme": true；或者误启用了 "draw_white_icons": true 导致全灰。
让 .env、.toml 这类文件也显示图标，别搜“图标包”
A File Icon 内置约 200 种扩展名映射（.js、.py、.md 等），但 .env、.conf、.toml 默认不识别——这不是遗漏，是设计如此。手动映射比换插件快得多，也更可控。
打开 Preferences → Package Settings → A File Icon → Settings – User，添加：
{
"icon_file_extensions": {
"env": "settings",
"toml": "config",
"conf": "config"
}
}
注意："settings"、"config" 必须是插件内置的图标名，可查 Packages/A File Icon/icons/ 目录下的文件名（不含后缀）；不支持直接填 Unicode 字符或路径；正则匹配要用 "patterns" 数组，例如 {"pattern": "\.env$", "icon": "settings"}。
文件夹也要彩色图标？开 colored_folders 并关掉动画
A File Icon 默认只处理文件，文件夹图标是独立开关。如果你看到文件有图标但文件夹还是小三角，就是这个没开。
在 Preferences → Package Settings → A File Icon → Settings – User 中加：
{
"colored_folders": true,
"folder_animation": false
}
"folder_animation": false 很关键——开启时展开/折叠文件夹会闪烁，尤其在高刷屏或深色主题下明显；关掉后图标稳定，刷新也更快。部分旧主题（如 Seti_UI）不支持彩色文件夹，建议换 Material Theme 或 Ayu Mirage。
图标错位、变小、截断？别怪插件，是主题和字号在打架
图标本质是字体图标（Octicons），靠 CSS 规则定位。一旦你调大编辑器字号、换非标准主题、或混用不同版本的 A File Icon 和主题，就容易出现图标偏移、上下居中失败、右边被截断等问题。
这不是 bug，是 Sublime 渲染机制限制。最稳的做法：
- 用
Adaptive.sublime-theme+ 默认字号（"font_size": 12或 13） - 避免手动修改
.sublime-theme文件里的"content_margin"或"layer0.texture" - 真要微调颜色或大小，用
Customize Theme插件改，而不是硬编码进主题文件
复杂点在于：同一套配置在 macOS 和 Windows 下可能表现不同（比如 "file_icons_osx": true 开关会影响图标基线），而这些细节几乎不会报错，只会静默失效。
