必须先装好Package Control，再安装并执行“Material Theme: Activate theme”命令激活；theme控制UI元素（如侧边栏、标签页），值须为完整.sublime-theme文件名（如Material-Theme-Darker.sublime-theme），color_scheme控制编辑区文字颜色，路径须大小写、斜杠、空格全匹配。
Package Control没装好，所有主题都白装——这不是可选项，是硬性前提。装完不激活、路径写错、大小写/斜杠/空格差一点，主题就静默失效，你只会觉得“怎么没反应”。
为什么装了主题但 UI 一点没变？
根本原因不是主题坏了，而是 theme 和 color_scheme 两套配置没同时生效，或路径不精确。
-
theme控制标签页、侧边栏、状态栏等 UI 元素外观，值必须是.sublime-theme文件名（如Material-Theme-Darker.sublime-theme），不能是文件夹名或缺后缀 -
color_scheme只管编辑区文字颜色，值必须是完整路径（如Packages/Material Theme/schemes/Material-Theme-Darker.tmTheme），大小写、斜杠方向（一律用/）、空格、扩展名全要对 - Sublime 不报错，错一点就回退到默认主题——查路径最可靠方式：按
Ctrl+Shift+P→ 输入UI: Select Theme看带 ✔️ 的当前主题名；再输Color Scheme，看状态栏实时显示的路径，直接复制粘贴
Material Theme 安装后必须执行激活命令
装完不等于启用。手动改配置容易漏关键参数（比如 material_theme_compact_sidebar 或图标开关），而 Material Theme: Activate theme 命令会一并写入 theme、color_scheme、file_icons 和高亮色配置。
- 确保
Package Control已安装：按Ctrl+`调出控制台，粘贴官网最新脚本（2026 年仍有效），执行后重启，再按Ctrl+Shift+P能搜到Package Control才算成功 - 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索Material Theme（注意不是MaterialTheme或Material-Theme）→ 回车安装 - 装完立刻再按
Ctrl+Shift+P→ 输入Material Theme: Activate theme→ 回车。如果命令面板里搜不到，说明插件未加载，重启 Sublime 后重试 - 侧边栏没变暗？检查是否选中了带
-Darker或-Dark后缀的主题文件（如Material-Theme-Darker.sublime-theme），默认的Material-Theme.sublime-theme是浅色 UI
Sublime Text 4 要小心 .tmTheme 和 .sublime-color-scheme 格式混用
ST4 默认只认 .sublime-color-scheme，老的 .tmTheme 文件直接扔进去不会出现在配色菜单里，也不能靠改后缀解决。
- 下载主题时确认仓库包含
.sublime-color-scheme文件（如 Ayu、Dracula 的 ST4 分支）；若只有.tmTheme，必须用tmtheme2subl等工具转换，不能手动重命名 - 主题文件夹必须拖进
Packages/目录（路径可通过Preferences → Browse Packages查看），不能放Packages/User/—— 放错位置，Sublime 根本不扫描 - 自定义配色方案时，
variables和globals字段缺一不可，foreground/background必须用var()引用，不能直接写值；rules里的scope必须精准匹配（查真实 scope 用Ctrl+Shift+P→Developer: Show Scope Name）
图标不显示？大概率是 file_icons 没开或冲突了
Material Theme 自带图标支持，但默认不强制启用；旧版 File Icons 插件和它共存会互相覆盖。
- 用户设置里必须显式加这一行：
"file_icons": true（ST4 必须写，不写就没有图标） - 检查
ignored_packages设置，确保没把Material Theme加进去 - 别同时装
File Icons和Material Icon Theme—— Material Theme 自带逻辑，多装一个反而失效 - macOS/Linux 用户建议加
"file_icons_osx": true或"file_icons_linux": true；用 Soda/Flatland 主题需额外加"file_icons_soda": true等兼容开关
真正卡住人的从来不是“找不到主题”，而是 theme 和 color_scheme 这两个字段的路径细节：一个字母大小写不对、斜杠方向反了、空格多了一个，Sublime 就当没看见——它不报错，也不提示，只默默退回默认。
