Material Theme需手动激活并配置依赖：先通过Package Control安装并重启，再执行激活命令写入theme等设置，同时安装Icons等配套插件，调整font_options等渲染参数以适配高分屏。
装完没反应，不是插件坏了，是缺激活、少依赖、路径写错或渲染配置冲突——Material Theme 不是“装上就变美”，它是一套需手动对齐的 UI 组件链。
Package Control 没装稳，后面全白忙
Material Theme 必须通过 Package Control 安装，控制台执行安装脚本后不重启，插件管理器根本不会加载。很多人卡在“命令面板搜不到 Material Theme”，根源就在这一步没闭环。
- 按
Ctrl+`调出控制台，粘贴并执行官网最新脚本（2026 年仍有效）：import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation').read().decode('utf-8')) - 执行完必须重启 Sublime Text；重启后按
Ctrl+Shift+P输入Package Control，能看见选项才算成功 - 若提示 SSL 错误或超时，说明网络受限，此时应手动下载
package_control.sublime-package，解压到Packages/目录（路径可通过Preferences → Browse Packages查看）
装完不生效？缺的是激活命令，不是重装
安装 ≠ 启用。Material Theme 安装后默认处于禁用状态，theme 和 color_scheme 配置项不会自动写入用户设置。只装不激活，界面一动不动。
- 装完立即按
Ctrl+Shift+P→ 输入Material Theme: Activate theme→ 回车 - 这一步会一次性写入
theme、color_scheme、图标风格和高亮色，比手动改更可靠 - 如果命令面板里没出现这个选项，说明插件未加载成功，重启 Sublime 后重试
- 别信“装完自动生效”的说法——它连
theme字段都不会往Settings – User里写
侧边栏/标签页还是灰的？你只改了配色，没换 UI 主题
color_scheme 只管编辑区文字颜色，theme 才控制侧边栏、标签页、状态栏这些 UI 元素。很多人把 Material-Theme-Darker.tmTheme 当成主题文件名，结果只换了代码颜色，UI 还是原生灰。
- 确认当前启用的主题：按
Ctrl+Shift+P→ 输入UI: Select Theme，带 ✔️ 的才是真正在用的.sublime-theme文件 - 正确值必须是完整文件名，含大小写、空格、后缀：
"Material-Theme-Darker.sublime-theme"，不是"Material Theme"或"MaterialTheme" - 深色 UI 还要额外开关，比如加这一行：
"material_theme_background_panel": true - 图标不显示？不是主题问题，是缺
Material Theme Icons插件——它负责把文件夹、.js、.py 这些变成带图标的节点
字体发虚、高 DPI 屏幕模糊？subpixel_antialias 在 ST4 上是反效果
Material Theme 默认开启 subpixel_antialias，但在 Windows + 高分屏 + Sublime Text 4 组合下，会导致文字边缘泛白、细节糊成一片，尤其小字号明显。
- 打开
Preferences → Settings，在右侧用户设置中加这一行："font_options": ["gray_antialias"] - macOS 用户若启用了
hidpi_scale_factor，需同步检查material_theme_bold_tab_font是否设为true，否则 tab 字体会过细 - 别碰
font_face里带Medium或Semibold的变体——ST4 对这类字体权重解析不稳定，容易触发渲染异常 - 改完设置务必重启 Sublime，热重载对部分 UI 元素无效
最常被忽略的其实是依赖关系：Material Theme 本体只提供骨架，Appbar、Quick Panel、Icons 这三个插件才是让侧边栏、弹窗、文件图标真正“活起来”的关键。少一个，UI 就断一块。
