Material Theme 安装前必须先安装 Package Control，否则无法搜索和安装；安装后需通过命令面板执行“Material Theme: Activate theme”手动激活，且须正确配置 theme 和 color_scheme 路径，二者缺一不可。
Material Theme 安装前必须确认 Package Control 已就位
没装 Package Control，后续所有主题安装都会失败——它不是可选插件，而是 sublime 的“应用商店”底层依赖。很多人卡在“搜不到 Material Theme”，根源就是这一步跳过了。
- 按
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 错误或超时，说明网络受限，需手动下载安装包解压到
Packages目录（路径见下文），但这是备选方案，不推荐长期使用
用命令面板一键安装并激活，别只装不启
安装 ≠ 启用。Material Theme 装完后界面纹丝不动，是新手最高频的困惑点——它不会自动替换 ui，必须手动触发激活逻辑。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索Material Theme→ 回车安装 - 装完立刻再按
Ctrl+Shift+P→ 输入Material Theme: Activate theme→ 回车
✅ 这一步会同时写入"theme"和"color_scheme"，还配置好图标、高亮色等配套项，比手动改设置更可靠 - 如果没看到这个命令，说明安装未完成或插件加载异常，可尝试重启 Sublime 后重试
手动配置时，路径和后缀一个字母都不能错
想自定义或排查问题时，常要编辑 Preferences → Settings 用户配置。这里极易因大小写、空格、斜杠方向出错，导致主题不生效或报错。
-
"theme"的值必须是.sublime-theme文件名，不是文件夹名：
正确："Material-Theme.sublime-theme"
错误："Material Theme"（缺后缀）、"MaterialTheme"（大小写/空格不符） -
"color_scheme"必须是完整路径，且区分大小写：
正确："Packages/Material Theme/schemes/Material-Theme-Darker.tmTheme"
错误："Packages/MaterialTheme/..."（少空格）、"material-theme-darker.tmTheme"（小写路径在 macOS/linux 下无效） - 不确定路径？先用命令面板执行
Color Scheme，看状态栏显示的实时路径，直接复制粘贴最安全
启用后标签页/侧边栏没变黑？检查是否混用了主题和配色方案
Material Theme 是 UI 主题，只管菜单、标签、侧边栏；而 Monokai、Solarized (Dark) 这类是配色方案，只管代码区颜色。两者独立，必须配对使用才能实现“全黑效果”。
- 如果只改了
"color_scheme"却没设"theme"，界面仍是默认灰白风 - 如果只设了
"theme"但"color_scheme"指向一个浅色方案（如.../Light.tmTheme），代码区会突兀发亮 - Material Theme 自带多套配色，推荐优先用它配套的：
Material-Theme-Darker.tmTheme（深黑）、Material-Theme-Lighter.tmTheme（浅灰），路径都在Packages/Material Theme/schemes/下
真正容易被忽略的是：主题激活后，部分 UI 元素（比如新打开的标签页、刚展开的侧边栏）才刷新样式——不是所有区域都实时重绘。如果改完没立刻看到变化，试着新建一个文件或切换一下侧边栏，再观察。