Sublime Text 需安装 FileIcons 插件并搭配兼容主题（如 Adaptive）才能显示文件图标；手动修改主题或插件源码易出错，新扩展名可通过用户配置映射图标，高分屏下图标模糊应避免手动 dpi_scale 设置。
怎么让 Sublime Text 显示文件图标
Sublime Text 默认不显示文件图标，得靠插件实现。最稳定、维护活跃的是 FileIcons，不是 A File Icon（后者已停止更新，且在 Sublime Text 4 下常失效）。
安装方式很简单：用 Package Control 装 FileIcons，装完重启一次 Sublime 就生效。别手动下载 zip 解压——路径错一位图标就不显示，而且后续升级会断。
- 确保已安装
Package Control（没装的话搜 “install package control sublime” 一行命令搞定） - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Install Package回车 - 等列表加载完，输入
FileIcons，选中后回车 - 关掉所有窗口，彻底退出 Sublime 再重开——图标才真正渲染出来
为什么装了图标还是不显示
常见原因是主题不兼容。Sublime 的图标依赖 UI 主题的 icon set 支持，FileIcons 只提供图标资源，不改 UI 结构。
默认主题 Default 完全不支持图标；主流兼容主题只有 Adaptive（自带）、Theme - Soda、ayu 等少数几个。如果你用的是自定义主题或老旧主题，图标大概率白屏或显示为方块。
- 临时验证：菜单栏 →
Preferences→Theme→ 切成Adaptive.sublime-theme - 如果这时图标出来了，说明问题出在你当前主题上，不是插件没装好
- 不要强行修改主题文件加 icon 字段——Sublime Text 4 对 icon 渲染逻辑有调整，硬改容易导致侧边栏错位或崩溃
文件类型图标不匹配或缺失
FileIcons 自带约 200 种语言/扩展名映射，但不会覆盖全部。比如 .astro、.svelte、.tsp 这类新扩展名，默认没图标，显示为通用文档图标。
可以手动补映射，但必须写进用户配置，不能动插件源码——否则下次更新就清空了。
- 菜单栏 →
Preferences→Package Settings→FileIcons→Settings – User - 在里面加一条：
"file_icons": {"astro": "html"}，表示把.astro当作.html显示图标 - 值必须是插件已支持的图标名（如
js、css、folder），不能随便写astro - 改完保存，不用重启，图标会自动刷新（如果没变，试试关闭再打开侧边栏）
图标显示模糊或缩放异常
这是 DPI 缩放和图标资源尺寸不匹配导致的，尤其在高分屏（如 macOS Retina、Windows 150% 缩放）下明显。Sublime Text 本身不支持矢量图标，FileIcons 提供的是 1x/2x 两套 PNG，但某些主题加载时取错了分辨率档位。
目前没有一劳永逸的修复，但可降低干扰：
- 避免在
Preferences → Settings里设置"dpi_scale": 1.5这类手动缩放——它会让图标拉伸变形 - 确认系统缩放设置是否被 Sublime 拦截：Windows 上右键 Sublime 快捷方式 → 属性 → 兼容性 → 取消勾选“替代高 DPI 缩放行为”
- macOS 用户如果用
Retina主题，建议换回Adaptive，后者对 2x 图标适配更稳
图标本质是视觉增强，不是功能必需。一旦发现它引发侧边栏滚动卡顿、文件名重叠或主题样式错乱，直接禁用 FileIcons 比折腾配置更省时间。
