必须先安装package control，再依次安装ui主题（如material theme）和图标插件（如a file icon），然后在settings – user中严格按大小写、空格、后缀配置"theme"和"icon_theme"字段，并重启sublime text生效。
如何通过Package Control安装UI主题和图标包
Sublime Text本身不自带可切换的UI主题或图标皮肤，所有视觉美化都依赖第三方Package。必须先确保已安装Package Control——如果按默认方式安装过Sublime Text 4，它通常已预装；若不确定，用Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板，输入Package Control: Install Package，能执行就说明已就位。
安装主题和图标需分两步，且顺序不能错：先装UI主题（控制侧边栏、标签页、状态栏等），再装图标插件（替换文件/文件夹图标）。常见组合如Material Theme + A File Icon，或Origami + FileIcons。
实操建议：
- 在命令面板中依次执行
Package Control: Install Package→ 输入Material Theme→ 回车安装；再同样操作安装A File Icon - 安装后不自动启用，需手动配置
Preferences → Settings – User，往JSON里加"theme"和"icon_theme"字段 - 别跳过重启步骤：安装完图标包后，务必关闭并重新打开Sublime Text，否则图标不会渲染
修改Settings – User启用主题和图标的关键字段
直接编辑Preferences → Settings – User是唯一生效方式，改Settings – Default无效且下次升级会被覆盖。两个字段必须同时存在，缺一不可，且值必须与已安装包的名称完全一致（大小写、空格、连字符都不能错）。
例如使用Material Theme和A File Icon时，配置应为：
{
"theme": "Material-Theme.sublime-theme",
"icon_theme": "A File Icon"
}
常见错误现象：
-
"theme": "Material Theme"→ 错，正确是"Material-Theme.sublime-theme"（注意连字符和后缀） -
"icon_theme": "a file icon"→ 错，大小写敏感，必须是"A File Icon" - 只配了
theme没配icon_theme→ 图标不显示，但UI会变 - 配了但拼写与Package名不一致 → Sublime静默忽略，无报错，界面毫无变化
图标不显示的三个高频原因和对应检查点
即使主题和图标包都装了、配置也对，图标仍不出现，大概率卡在这三处。
第一，文件类型未被图标包识别：A File Icon默认只给常见语言（如.js、.py、.html）和项目文件（package.json、README.md）分配图标；像.env、.yml或自定义后缀需手动映射。方法是在Preferences → Package Settings → A File Icon → Settings里添加file_extensions规则。
第二，侧边栏宽度不够：A File Icon的图标比原生宽，若侧边栏拖得太窄，图标会被截断或退化为默认小圆点。把侧边栏拉宽到至少200px再观察。
第三，其他插件冲突：某些UI增强插件（如BracketHighlighter旧版、SyncedSideBar）会劫持文件视图逻辑。临时禁用其他插件，仅保留主题+图标包测试，可快速定位。
Material Theme的深色/浅色模式切换不是靠系统，而是靠主题变体
Material Theme本身不读取系统暗色模式设置，它的“深色”“浅色”是不同主题文件。比如Material-Theme-Darker.sublime-theme和Material-Theme-Lighter.sublime-theme是独立文件，必须显式指定。
切换方式就是改Settings – User里的"theme"值：
- 深色：
"theme": "Material-Theme-Darker.sublime-theme" - 浅色：
"theme": "Material-Theme-Lighter.sublime-theme" - 默认（半深）：
"theme": "Material-Theme.sublime-theme"
注意：每次换主题都要重启Sublime Text，热重载不生效。另外，部分变体（如Darker）对字体抗锯齿、高DPI缩放更敏感，若文字发虚，可在同一配置里加"font_options": ["gray_antialias"]微调。
真正容易被忽略的是：图标颜色并不会随主题变体自动适配。比如在Darker下，某些图标可能因底色太深而看不清，这时得去A File Icon的设置里手动调整colorize_modified_tabs或use_colored_icons开关。
