必须先安装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，路径和配置都要同步改，不能只换一半。