material theme 界面未变是因 theme 与 color_scheme 未配对生效或未激活，关键在三步：package control 安装失败、未运行“material theme: activate theme”、路径大小写或空格错误。
装完 Material Theme 界面没变，不是主题坏了，是 theme 和 color_scheme 没配对生效，或者根本没激活——90% 的“失效”问题卡在这三步：Package Control 没装稳、没运行 Material Theme: Activate theme、路径大小写或空格错了一处。
Package Control 装不成功，后面全白忙
Sublime Text 4 默认禁用非 HTTPS 仓库，旧版 channel 已停用，必须用官网最新脚本安装。控制台（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查看） - 别长期依赖手动方案，网络恢复后建议重装以保证更新通道正常
装了但 UI 一动不动？你漏了激活命令
安装 ≠ 启用。Material Theme 不会自动写入配置，只装不激活，UI 完全静默。
正确流程是：
-
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索Material Theme（注意有空格，不是MaterialTheme）→ 回车安装 - 装完**不要重启**，立刻再按
Ctrl+Shift+P→ 输入Material Theme: Activate theme→ 回车 - 如果命令面板里搜不到这个命令，说明插件未加载，重启 Sublime 后重试
这一步会一次性写入 theme、color_scheme、图标开关等，比手动改设置更可靠。
theme 和 color_scheme 路径一个字符都不能错
Sublime 不报错，错一点就静默回退到默认主题。最稳妥方式是直接从 UI 复制路径：
-
Ctrl+Shift+P→ 输入UI: Select Theme，看带 ✔️ 的当前主题名，例如：Material-Theme-Darker.sublime-theme - 再输入
Color Scheme，看状态栏实时显示的路径，例如：Packages/Material Theme/schemes/Material-Theme-Darker.tmTheme - 打开
Preferences → Settings – User，右侧粘贴这两行（以深色为例）：
{
"theme": "Material-Theme-Darker.sublime-theme",
"color_scheme": "Packages/Material Theme/schemes/Material-Theme-Darker.tmTheme"
}
注意硬性细节：
-
theme值必须是.sublime-theme文件名，不是文件夹名，且大小写、空格、连字符全要一致 -
color_scheme必须是完整路径，斜杠一律用/，不能用\或双斜杠 - 别加已废弃的配置项，比如
material_theme_background_panel（v5.0+ 已移除，加了反而失效）
图标不显示、字体发虚、侧边栏颜色割裂？不是主题问题，是配套没跟上
Material Theme 是一套 UI 组件链，不是单个文件。常见现象对应真实原因：
- 侧边栏/标签页还是灰的 → 只改了
color_scheme，没换theme；color_scheme只管编辑区文字颜色，theme才控制侧边栏、标签页、状态栏 - 图标空白 → 缺
Material Theme Icons插件，或没开"file_icons": true（ST4 必须显式开启） - 字体发虚、高 DPI 屏幕模糊 →
subpixel_antialias在 Windows + 高分屏 + ST4 下是反效果，应改为"font_options": ["gray_antialias"] - 状态栏和编辑区背景色不一致 →
theme和color_scheme配色逻辑没对齐，比如用了Material-Theme-Darker.tmTheme却配了Material-Theme.sublime-theme
复杂点在于：所有组件必须版本对齐、路径对齐、开关对齐——少一个环节，UI 就断在某一处，而且不会报错，只会“看起来差不多”。
