必须先安装package control才能安装material theme，安装后需手动执行“material theme: activate theme”命令激活，且theme和color_scheme路径须严格匹配大小写、空格及后缀。
Material Theme 安装前必须装好 Package Control
没装 Package Control，就根本搜不到 Material Theme——它不是“可选插件”，而是 sublime 的插件分发底层。很多人卡在“安装失败”或“命令面板里找不到”，问题全出在这一步。
- 按
Ctrl+`（反引号）调出控制台，粘贴并执行官网最新安装代码：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 界面毫无变化？不是插件坏了，是你没触发它的激活逻辑。它不会自动写入 theme 和 color_scheme，必须显式调用激活命令。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索Material Theme→ 回车安装 - 装完立刻再按
Ctrl+Shift+P→ 输入Material Theme: Activate theme→ 回车 - 这一步会一次性配置好
theme、color_scheme、图标风格和高亮色，比手动改设置更可靠；如果没看到这个命令，说明插件加载异常，重启 Sublime 后重试
手动配置时路径和后缀一个字母都不能错
想自定义或排查问题时，常要编辑 Preferences → Settings – User，这里极易因大小写、空格、斜杠方向出错，导致主题不生效甚至报错。
-
"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，看状态栏显示的实时路径，直接复制粘贴最安全
侧边栏/标签页没变黑？大概率是混用了主题和配色方案
theme 控制 ui（标签页、侧边栏、状态栏），color_scheme 只管代码语法颜色。二者完全独立，换错地方或路径不匹配，就会“颜色变了但 UI 没变”或“UI 变了但代码还是白底黑字”。
- 确认当前设置：按
Ctrl+Shift+P→ 输入UI: select Theme看勾选项；再输入Color Scheme看高亮项和状态栏路径 - 部分主题（如
Material Theme）还依赖额外设置项，比如"material_theme_accent_red": true，不加可能看不到高亮色变化 - 图标不显示？顺带安装
A File Icon插件，并确保用户设置中启用了对应兼容项（如"file_icons_soda": true）
真正容易被忽略的，不是“怎么装”，而是“装完要不要动设置”以及“theme 和 color_scheme 必须同时对、同时准”。路径里多一个空格、少一个大写、斜杠方向反了，都会让整个主题失效——它不报错，只是沉默地退回默认界面。