sublime text 主题或配色不生效，主因是路径错误、json语法非法或误改default设置；需确保theme含完整后缀、color_scheme以packages/开头且大小写精确，仅在user设置中修改并验证json合法性。
Sublime Text 自定义主题（.sublime-theme）或配色方案（.sublime-color-scheme）不生效，**几乎从来不是“安装失败”，而是路径、格式或配置层级出错导致 Sublime 静默忽略——它不报错，也不提示，直接回退到默认主题。**
检查 Preferences.sublime-settings 里 theme 和 color_scheme 的值是否精确匹配文件名
Sublime 对大小写、空格、斜杠方向、后缀名极度敏感，错一个字符就失效。
-
theme必须是完整文件名，含.sublime-theme后缀，例如："Material-Theme-Darker.sublime-theme"，不能写成"Material Theme"或"material-theme-darker.sublime-theme" -
color_scheme必须是Packages/开头的相对路径，且大小写完全一致，例如："Packages/Material Theme/schemes/Material-Theme-Darker.tmTheme"，不能漏掉Packages/，也不能把空格写成下划线 - Windows 用户也必须用正斜杠
/，不能用反斜杠\；路径中含空格（如Material Theme）必须保留，不能删 - 最稳妥的方式：先通过菜单 Preferences → Color Scheme 手动选一次，看状态栏实时显示的路径，直接复制粘贴进
Preferences.sublime-settings
确认你编辑的是 User 设置而非 Default 设置
菜单里打开 Preferences → Settings 是左右分栏：左侧是只读的 Default，右侧才是你要改的 User。很多人在左侧改了，重启后一切复原——因为 Default 每次升级都会被覆盖。
- 务必只在右侧（标注为
Preferences.sublime-settings — User）里写配置 - 右侧初始为空或只有
{}，你加的每一项都是覆盖Default中同名项 - 如果右侧为空，
theme和color_scheme就完全不会生效
验证 JSON 语法是否合法，一个逗号错误就会让整份配置静默失效
Preferences.sublime-settings 是 JSON 格式，任何语法错误（比如最后一行多逗号、用了中文引号、缺引号、注释）都会导致 Sublime 直接跳过整个文件，不报错，也不提示。
- 检查最后一行是否有多余逗号 —— JSON 不允许
- 所有 key 和字符串值必须用英文双引号
"，不能用'或中文引号 - 保存后看窗口标题栏是否有
*，没消失说明没真正保存成功 - 右键当前 Settings 文件 → JSON → Validate（若无此选项，先装
SublimeLinter-json）
区分 UI 主题（.sublime-theme）和配色方案（.sublime-color-scheme），别混改
UI 主题控制侧边栏、标签页、状态栏等界面元素；配色方案控制代码编辑区的背景、字体颜色、括号高亮等。二者是独立加载、分别配置的，改错地方只会变一半。
- 想改代码区背景色（比如豆沙绿），要改
.sublime-color-scheme文件里的globals.background字段，不是去动.sublime-theme - 想改侧边栏颜色或图标样式，得编辑
.sublime-theme文件，搜索"class": "sidebar_container"等 class 名 - ST4 只认
.sublime-color-scheme（JSON 格式），老的.tmTheme（XML 格式）已彻底弃用，不能靠改后缀解决 - 自定义配色推荐用 Preferences → Customize Color Scheme 自动生成
Custom.sublime-color-scheme，这是唯一支持热重载的用户级入口
真正卡住的地方，往往不是“怎么装”，而是“它根本没读你写的那行”。路径拼写、JSON 格式、设置文件位置，三者只要一个没对齐，Sublime 就当那行配置不存在——这种静默行为最容易让人反复折腾却找不到原因。
