Package Control未安装或失效是Material Theme装不上的主因,需手动安装并重启;安装后须执行“Material Theme: Activate theme”命令激活,且需配套安装Icons等组件并正确配置路径。

装不上 Material Theme,八成不是主题问题,而是 Package Control 没装好、没激活、或路径写错——它不自动生效,也不容许大小写/空格/后缀出错。
Package Control 没装或失效,Material Theme 根本搜不到
很多人卡在“命令面板里搜不到 Material Theme”,根源是 Package Control 未安装或加载失败。Sublime 不自带插件市场,Package Control 是唯一可靠入口。
- 按
Ctrl+`(反引号)调出控制台,粘贴并执行官网最新安装代码(2026 年仍有效):import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation').read().decode('utf-8')) - 执行完必须重启 Sublime;重启后按
Ctrl+Shift+P输入Package Control,能看见下拉选项才算成功 - 若提示 SSL 错误或超时,说明网络受限,此时手动下载
package_control.sublime-package,放进Packages/目录(路径可通过Preferences → Browse Packages查看)
装完没变化?你漏了 Material Theme: Activate theme 这一步
Material Theme 安装后默认禁用,不会自动写入 theme 和 color_scheme。只装不激活,界面一动不动。
- 安装完成后,立刻再按
Ctrl+Shift+P→ 输入Material Theme: Activate theme→ 回车 - 这个命令会一次性配置好
theme、color_scheme、图标风格和高亮色,比手动改设置更可靠 - 如果命令面板里没出现该选项,说明插件未加载,重启 Sublime 后重试;仍不出现,检查
Packages/Material Theme/目录是否存在且非空
侧边栏/标签页还是灰的?theme 和 color_scheme 路径必须一字不差
color_scheme 只影响编辑区文字颜色,theme 才控制侧边栏、标签页、状态栏等 UI 元素。二者路径都错不得,尤其大小写、空格、斜杠方向、后缀名。
- 正确示例:
"theme": "Material-Theme-Darker.sublime-theme""color_scheme": "Packages/Material Theme/schemes/Material-Theme-Darker.tmTheme" - 常见错误:
"Material Theme"(缺.sublime-theme)、"material-theme-darker.tmtheme"(小写路径在 macOS/Linux 下无效)、Packages\Material Theme\...(Windows 也必须用正斜杠/) - 不确定路径?用命令面板输入
Color Scheme,状态栏显示的实时路径直接复制最安全;输入UI: Select Theme看当前启用项前是否有 ✔️
图标空白、字体发虚、深色侧边栏不生效?配套组件和渲染设置不能少
Material Theme 不是单个文件,而是一套组合:UI 主题 + 图标集 + 渲染微调。缺任何一环,都会出现视觉断层。
- 图标为空?必须装
Material Theme Icons(单独搜索安装),否则文件夹/文件类型图标显示为方块 - 字体发虚(尤其 Windows 高分屏 + ST4)?在
Preferences → Settings用户设置中加:"font_options": ["gray_antialias"] - 侧边栏/标签页没变黑?确认启用的是带
-Darker或-Dark后缀的主题文件,并加配置:"material_theme_background_panel": true - 启用前务必关掉其他主题类插件(如
Theme - Soda、Theme - Flatland),避免theme和color_scheme配置冲突
最容易被忽略的是:所有配置改完后必须重启 Sublime,热重载对部分 UI 元素(比如 Appbar、Quick Panel)完全无效;还有就是 Material Theme Icons 和 Material Theme Appbar 这两个配套包,不装它们,再漂亮的主题也只是半成品。

















