要实现文件图标按类型着色，必须使用 FileIcons 插件并满足三个条件：启用 FileIcons Theme 或兼容主题、使用含 icon_filetype* 作用域的配色方案、设置 draw_white_icons 为 false；A File Icon 仅换图标不支持着色。
图标不着色？先确认你用的是哪个插件
Sublime Text 原生根本不支持图标着色，所有颜色变化都靠插件驱动。目前真正能「按类型着色」的只有 FileIcons ——它通过为不同扩展名绑定 icon_file_type_* 这类作用域，再由配色方案（color_scheme）定义这些作用域的颜色。而 A File Icon 虽然图标丰富，但它只注入 CSS 类（如 .icon-file-type-js），本身不控制颜色，也不提供作用域映射，所以无法实现「着色」，只能换图标。
常见错误现象：
装了 A File Icon 却想调颜色，折腾半天发现配色方案里根本找不到对应作用域；或者同时装了 FileIcons 和 A File Icon，两者冲突导致图标全灰或部分消失。
- 如果你要的是「.py 显示蓝色 Python 图标」「.js 显示黄色 JS 图标」这种效果 → 选
FileIcons - 如果你只要「.py 显示 Python 图标」「.md 显示文档图标」这种基础区分 →
A File Icon更轻量、更稳定 - 别两个都装——
ignored_packages里哪怕只禁用其中一个，也可能让另一个失效
FileIcons 着色生效的三个硬性条件
FileIcons 安装后图标还是灰白？不是插件没装好，而是这三个环节必须全部对齐：
- UI 主题必须是
FileIcons Theme（Preferences → Theme →FileIcons Theme），或明确启用图标的主题（如Material Theme需在设置中加"file_icons": true） - 配色方案必须是
FileIcons Default或其他含icon_file_type_*作用域定义的方案（Preferences → Color Scheme →FileIcons→FileIcons Default） - 确保
draw_white_icons是false（在Preferences → Package Settings → FileIcons → Settings中检查）
容易踩的坑：
很多人换了 color_scheme 却忘了切 theme，结果图标显示了但全是白色；或者用了项目级配置（.sublime-project），里面硬编码了 "color_scheme"，把全局设置覆盖掉了。
自定义某类文件的图标颜色（比如让 .env 变青色）
想让冷门后缀也着色，得走「扩展名 → 作用域 → 颜色」三步链路，不能跳步。
- 第一步：在
FileIcons设置里映射扩展名到作用域，例如：{ "file_extensions": { "env": "icon_file_type_settings" } } - 第二步：确认当前
color_scheme（比如FileIcons Default.tmTheme）里真有icon_file_type_settings的颜色定义；没有就自己加（需懂 tmTheme XML 格式） - 第三步：如果只是想快速试效果，可临时改用
FileIcons Default方案，它已预置了icon_file_type_settings（青色）、icon_file_type_config（紫色）等常用项
注意：icon_file_type_settings 这类名字不能随便写，必须和配色方案里定义的作用域名完全一致，大小写、下划线都不能错。
Sublime Text 4 用户特别注意兼容性
截至 2026 年 3 月，FileIcons v3.x 是唯一适配 ST4 的版本，要求 build ≥ 4126；如果你还在用旧版 ST4（比如 4113），装了 v3.x 也会静默失效。
- 检查方式：菜单栏 → Help → About，看 build 号
- ST4 用户务必通过 Package Control 重装最新
FileIcons（作者是sublimelsp），别误装 ST3 时代的同名旧包 - 如果图标突然在某个项目里变回默认，先查
.sublime-project是否锁死了color_scheme或theme
最常被忽略的一点：着色逻辑依赖作用域匹配，而作用域又受语法定义影响。比如一个 .conf 文件如果被识别为 text.plain，那无论你怎么配 file_extensions，FileIcons 都不会给它绑作用域——得先确保该文件类型有正确语法高亮（比如装 INI 插件）。
