必须先安装package control，再通过命令面板执行“package control: install package”搜索安装material theme，装完立即运行“material theme: activate theme”激活，且theme和color_scheme路径须严格匹配大小写、空格及后缀。
Material Theme 能正常启用的前提是：必须同时正确配置 theme 和 color_scheme 两项，且路径大小写、扩展名、空格都必须完全匹配 Package Control 实际安装后的文件结构——错一个字符，UI 就只变一半。
怎么用 Package Control 安装 Material Theme
别手动下载 ZIP 或拖文件进 Packages 目录，那容易漏依赖、路径错乱、后续无法更新。唯一推荐方式是走 Package Control：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）呼出命令面板 - 输入
Install Package，回车选择Package Control: Install Package - 等待列表加载完成，输入
Material Theme（注意不是MaterialTheme或Material-Theme），回车安装 - 安装完成后，**不要重启**，直接改设置生效
用户设置里必须写的两行关键配置
打开 Preferences → Settings – User，右侧粘贴以下内容（以暗色模式为例）：
{
"theme": "Material-Theme.sublime-theme",
"color_scheme": "Packages/Material Theme/schemes/Material-Theme.tmTheme"
}
注意几个硬性细节：
-
theme的值必须是.sublime-theme文件名，不是文件夹名；Material-Theme.sublime-theme这个名字在 ST4 中严格区分大小写 -
color_scheme的路径必须和你用右键 →Copy Path从 Color Scheme 列表里复制出来的一致；如果装完没出现在列表里，说明安装不完整，重装一次 - 别加
"material_theme_background_panel": true这类开关——Material Theme 从 v5.0 起已移除该配置项，加了反而报错或失效
图标不显示？大概率是没开 file_icons
Material Theme 自带图标支持，但默认不强制启用。如果你侧边栏只有文字、没有文件类型图标（比如 .js 左侧没 JS 图标），检查设置里是否包含：
-
"file_icons": true（Sublime Text 4 必须显式开启） - 确认没同时启用冲突插件，比如旧版
FileIcons——Material Theme 自带图标逻辑，再装一个会互相覆盖 - 如果用了自定义
ignored_packages，确保没把Material Theme加进去
切换主题后部分区域颜色不对
常见现象：标签页变暗了，但侧边栏还是灰白；或者状态栏背景色和编辑区不一致。这不是主题 bug，而是 Sublime 的渲染机制限制：
- Material Theme 的配色方案（
.tmTheme）只控制编辑区文本背景，不接管状态栏、迷你地图、命令面板等区域 - 若想统一，得额外安装配套的
Material Theme - Appbar插件（通过 Package Control 搜这个名字），它专补这些 UI 缝隙 - 别试图用 CSS 补丁强行覆盖——Sublime 不支持用户级 CSS 注入，所有“修改 .sublime-theme”的手动编辑操作，在下次主题升级时都会被覆盖
最常被忽略的一点：Material Theme 的「深色/浅色」切换不是靠换 color_scheme，而是靠换 theme 文件名，比如 Material-Theme-Light.sublime-theme 对应亮色 UI，路径和配置都要同步改，不能只换一半。
