用Package Control安装Material Theme是唯一靠谱方式，因其能自动处理依赖、版本校验和激活逻辑，手动安装易因路径、权限或配置错误导致不生效。
用 Package Control 安装 Material Theme 是唯一靠谱方式
Sublime Text 本身不支持直接拖拽 ZIP 或双击安装主题，手动放 Package/ 目录容易路径错、权限错、重启后不生效。Package Control 是官方生态事实标准，它能自动处理依赖、版本校验和激活逻辑。
实操建议：
- 没装 Package Control？先用官网提供的 Python 片段在
Ctrl+`控制台里粘贴执行——别跳过这步，否则后面所有操作都白搭 - 装好后按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Install Package回车 - 等几秒等列表加载完，再输入
Material Theme，选中后回车——注意别选错成Material Theme Appbar或旧版Theme - Material - 安装完不会自动启用，必须手动设置：菜单
Preferences → Settings – User，在 JSON 里加两行："theme": "Material-Theme.sublime-theme",<br>"color_scheme": "Packages/Material Theme/schemes/Material-Theme.tmTheme"
路径大小写和拼写必须完全一致，尤其sublime-theme不是sublime-theme的变体
启用后界面没变化？大概率是 color_scheme 路径或 scope 冲突
Material Theme 分两层：UI 主题（theme）控制侧边栏、标签页样式；配色方案（color_scheme）管代码高亮。很多人只改了 theme，忘了配 color_scheme，结果看到的还是默认暗灰 UI + 原生高亮，误以为“没装上”。
常见错误现象：
- 标签页变圆角、侧边栏变深色，但代码颜色还是蓝黄混搭 →
color_scheme没设对，或路径指向了已删除的旧版文件 - 设置了
color_scheme却报Unable to find color scheme→ 路径里写了Material-Theme（带短横），实际目录名是Material Theme（空格），Windows 下不敏感，macOS/Linux 会失败 - 某些语言（如 Python、JSON）高亮异常 → Material Theme 默认用的是
Monokai衍生色板，若你之前装过其他语法包（比如Neon Color Scheme），它的scope规则可能覆盖 Material 的定义，得进Preferences → Package Settings → Material Theme → Settings关掉disable_file_icons外的干扰项
字体渲染发虚、图标错位？关掉 Sublime 的 font_options
Material Theme 对字体渲染很敏感，尤其在 macOS 和高分屏 Windows 上。如果你启用了 "font_options": ["gray_antialias"] 或 ["subpixel_antialias"]，会导致图标模糊、行距不均、甚至标签页关闭按钮消失。
正确做法：
- 检查
Settings – User里有没有font_options字段，有就删掉——Material Theme 自己会根据系统选择最优渲染模式 - 如果必须调字体大小，只用
"font_size": 12，别碰font_face以外的渲染参数 - 图标错位常伴随
"enable_tab_scrolling": false一起出现，这不是 bug，是主题默认适配滚动标签设计，强行关掉会破坏布局，不如接受滚动或换小一点的tab_height
更新后主题崩了？别急着重装，先清缓存再重载
Material Theme 更新频繁，有时新版本会改 .sublime-theme 结构或移除旧 color_scheme 文件。直接重启 Sublime 往往无效，因为 UI 缓存没清。
快速恢复步骤：
- 菜单
Preferences → Browse Packages…，进Material Theme文件夹，删掉里面所有以.cache或.pyc结尾的文件（如果有） - 回到 Sublime，按
Ctrl+Shift+P，输UI: Reload Theme回车——这个命令比重启更彻底，能强制重读所有 theme 文件 - 如果还崩，打开
Console（Ctrl+`），看有没有类似Error loading colour scheme的报错，复制完整路径，去Packages/里确认对应文件是否存在，名字是否多了一个空格或大小写不对
真正麻烦的不是装不上，而是装上了但配色和 UI 层没对齐；这两个值只要有一个路径错、格式错、大小写错，就会静默失效，界面看起来“好像变了又好像没变”。
