Sublime Text 文件图标需插件、主题、用户映射三者协同：FileIcons 插件依赖配套图标主题（如 ayu），须在用户设置中配置 theme 和 file_extensions 映射，且 ST4 需用 v3.x 版本。
Sublime Text 本身不支持自定义文件图标显示 —— 这是原生限制，所有“文件图标美化”效果都依赖第三方插件模拟实现，且仅作用于侧边栏（sidebar）的文件/文件夹名称前的装饰性小图标，不是操作系统级的图标替换。
为什么装了 FileIcons 插件图标还是没变？
最常见原因是插件未正确激活或配置冲突：
-
FileIcons插件本身不带图标资源，必须额外安装配套的图标主题包（如Theme - Soda、Adaptive或ayu等支持图标的主题），否则只显示默认空白占位符 - 检查
Preferences → Settings – User中是否误删了"theme": "xxx.sublime-theme"行；若留空或值错误（比如写成"theme": "Default.sublime-theme"），图标会完全不渲染 - 部分主题（如
Material Theme）需单独启用 sidebar 图标开关："material_theme_small_file_icons": true - Sublime Text 4 要求插件和主题均更新至兼容版本，旧版
FileIcons（v2.x）在 ST4 下可能静默失效，应改用FileIconsv3.x（通过 Package Control 安装时注意看作者名是否为braver）
如何让 .env、.gitignore 等隐藏文件显示专属图标？
默认情况下，FileIcons 对点开头的文件识别较弱，需手动映射：
- 打开
Preferences → Package Settings → FileIcons → Settings - 在右侧用户设置中添加
"file_extensions"映射规则，例如：
{
"file_extensions": {
".env": "gear",
".gitignore": "git",
".editorconfig": "cog",
"Dockerfile": "docker"
}
}
图标名（如 gear、git）必须来自当前主题所支持的图标集，可查该主题文档或浏览其 .sublime-theme 文件中的 icon. 前缀 key；填错则 fallback 到默认问号图标。
图标显示错位、重叠或模糊怎么办？
本质是主题与 Sublime 渲染层的像素对齐问题，尤其在高 DPI 屏幕或缩放非 100% 时明显：
- 优先尝试更换更现代的主题，如
ayu或Origami，它们对图标尺寸和 baseline 有更精细控制 - 避免在
Settings – User中设置过大"font_size"（≥14），图标资源通常是 16×16px，字体过大时图标会被拉伸失真 - 禁用可能干扰 sidebar 渲染的插件，如
SideBarEnhancements的某些旧版本会覆盖FileIcons的 icon 注入逻辑 - Windows 用户若启用了系统级“修复缩放”，建议关闭并改用 Sublime 内置缩放：
"dpi_scale": 1.25（数值按需调整）
真正起作用的是主题 + FileIcons + 用户映射三者协同，缺一不可；别指望装一个插件就自动识别所有自定义后缀——图标资源有限，匹配逻辑靠显式声明，这点常被忽略。
