Sublime Text主题自定义需同时配置color_scheme（代码区）和theme（UI元素），二者独立且路径、格式、大小写必须完全精确匹配，否则静默失效。
Sublime Text 主题自定义不是改一个文件就能全变，它实际由两套完全独立的系统控制：color_scheme（管代码编辑区）和 theme（管侧边栏、标签页、状态栏等 UI 元素）。混着改、路径写错、格式不匹配，是 90% 以上“改了没反应”的根本原因。
怎么改代码编辑区颜色（color_scheme）
这是你盯着最久的部分，优先确保它生效。核心是修改或新建一个 .tmTheme 或 .sublime-color-scheme 文件，放在 Packages/User/ 目录下。
- 别手动写 XML：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入New Color Scheme，用 PackageDev 插件生成标准模板——避免结构错误 -
background和foreground必须是带#的十六进制色值，比如#1e1e1e；不支持rgb()、hsl()或英文名（如black） - 注释颜色要分清 scope：
comment.line（#或//）、comment.block（/* */）、comment.documentation（/** */），它们可各自设不同色 - 改完保存后，必须在
Preferences → Color Scheme里重新选一次你的主题——Sublime 不会自动加载刚保存的文件
怎么改侧边栏和标签页（theme）
UI 主题是 JSON 格式，文件名以 .sublime-theme 结尾。改错字段或路径，整个 UI 可能直接回退到默认样式，甚至部分区域变空白。
- 路径必须完整且大小写敏感：
"theme": "Packages/User/MyCustom.sublime-theme"——漏掉Packages/、写成packages/user或mycustom（小写），Sublime 就当不存在 - 侧边栏背景靠
"class": "sidebar_container"下的layer0.tint控制，值必须是长度为 3 的整数数组，例如[60, 90, 60]（豆沙绿），不是#3a405a或rgb(58, 64, 90) -
layer0.opacity必须设为1.0，否则tint不会真正显示出来 - 如果原主题用了
layer0.texture（比如噪点底图），想彻底禁用就得设为null - 改完保存后，部分变化（如树状目录背景）需关闭再打开一个新窗口才刷新；也可用命令面板运行
UI: Reload Theme
为什么改了没反应？常见失效场景
路径、格式、作用域三者任一出错，都会导致白忙活。尤其注意这些真实踩坑点：
-
Preferences.sublime-settings里写"sidebar_background": "#1e1e1e"是无效的——Sublime Text 4 完全忽略这个字段 - 装了
A File Icon但没图标？不是插件问题，而是当前.sublime-theme文件里没定义"class": "icon_folder"或"class": "icon_file_type" - 侧边栏文字看不清？只改
sidebar_container不够，还得同步调："class": "sidebar_row"（行背景）、"class": "label_control"（文字色）、以及当前color_scheme中"name": "Sidebar row"对应的foreground - 改的是
Packages/Color Scheme - Default/Monokai.tmTheme这类系统路径下的文件？每次升级 Sublime 就会被覆盖——所有自定义必须放在Packages/User/下
如何让不同文件类型用不同配色（如 .py 用 Solarized，.md 用 Monokai）
Sublime Text 不支持“按后缀切换 theme”，但可通过语法绑定间接实现 color_scheme 切换——本质是让不同后缀关联不同语法定义，再让每个语法指向专属配色文件。
- 先确认语法名：用
Ctrl+Shift+P→Set Syntax: Python，右下角状态栏会显示真实语法名（如Python、Markdown） - 打开对应语法定义文件：
View → Syntax → Open Syntax Definition，路径类似Packages/Python/Python.sublime-syntax - 在该文件末尾添加一行：
color_scheme: Packages/Color Scheme - Default/Solarized Dark.sublime-color-scheme - 保存后执行
Ctrl+Shift+P→Reload Syntax Definitions，或重启 Sublime - 注意优先级：如果装了
MarkdownEditing这类插件，它的Markdown.sublime-syntax会覆盖默认路径的修改，得去插件目录里改
最常被忽略的一点：theme 和 color_scheme 的路径必须严格匹配当前启用状态——查路径不要猜，用 Preferences → Color Scheme 和 Preferences → Theme… 右下角状态栏显示的实际路径为准。大小写、斜杠方向、空格，差一点就失效。
