Material Theme安装前必须先安装Package Control，否则无法搜索到；安装后需手动激活并配置theme、color_scheme等参数，且须指定带-Darker后缀的主题文件及启用相关UI开关。
Material Theme安装前必须装好Package Control
没装Package Control，就根本搜不到Material Theme——它不是“可选插件”，而是Sublime的插件分发底层。很多人卡在“安装失败”或“命令面板里找不到”，问题全出在这一步。
按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界面毫无变化？不是插件坏了，是你没触发它的激活逻辑。它不会自动写入theme和color_scheme，必须显式调用激活命令。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索Material Theme→ 回车安装 - 装完立刻再按
Ctrl+Shift+P→ 输入Material Theme: Activate theme→ 回车
这一步会一次性配置好theme、color_scheme、图标风格和高亮色，比手动改设置更可靠；如果没看到这个命令，说明插件加载异常，重启Sublime后重试。
侧边栏/标签页还是灰的？深色UI没生效
只改color_scheme是没用的——它只影响编辑区文字颜色，管不了菜单、侧边栏这些UI区域。Material Theme的深色效果依赖具体主题文件名，比如Material-Theme-Darker.sublime-theme。
- 必须在用户设置中指定带
-Darker或-Dark后缀的.sublime-theme文件，例如："theme": "Material-Theme-Darker.sublime-theme" - 部分UI元素（如侧边栏背景）还需额外开关：
"material_theme_background_panel": true - 别混用其他UI主题插件（如
Theme - Soda），它们会覆盖theme配置，导致冲突 - 改完设置后务必重启Sublime，热重载对部分UI元素无效
图标空白、字体发虚、配色不生效的常见原因
Material Theme不只是换颜色，它强依赖配套的UI组件和图标集。只装主题本体，sidebar、tabs、status bar等区域默认还是原生样式。
- 图标支持靠
Material Theme Icons，不装它，文件夹、文件类型图标会变成空白或方块 - Windows + 高分屏 + ST4组合下，
subpixel_antialias会让文字边缘泛白，应在用户设置中加："font_options": ["gray_antialias"] - 自定义
material_theme_accent没反应？检查是否拼写正确、是否被其他插件覆盖、是否在Preferences → Package Settings → Material Theme → Settings - User里修改（而非全局Settings） - 路径大小写、空格、斜杠方向、扩展名一个字母都不能错：例如
Packages/Material Theme/schemes/Material-Theme-Darker.tmTheme中Material Theme有空格、.tmTheme必须小写且带点
最稳妥的验证方式是用命令面板：UI: Select Theme看带✔️的主题名，Color Scheme看状态栏显示的实时路径——抄这个路径，基本不会错。
