高对比度主题需完整覆盖关键scope而非单纯调亮；默认monokai/one dark常漏comment、keyword.control等scope；验证用show scope name查真实scope，确保color_scheme rules中精确匹配；自定义须复制到packages/user/并显式指定路径；region.line等ui高亮需手动添加对应rule；语法文件与color_scheme必须协同生效。
高对比度主题不是调亮就行，得看 scope 渲染是否完整
默认启用的 Monokai 或 One Dark 主题表面看着对比强，但实际常漏掉 comment、keyword.control 等关键 scope 的 foreground 覆盖，导致注释灰得看不见、控制关键字和普通变量颜色雷同。这不是亮度问题，是配色方案里 rules 数组没写全。
验证方法：打开任意代码文件，把光标停在 if 上，按 Ctrl+Shift+P 输入 Show Scope Name 回车，右下角会显示类似 keyword.control.python 的完整作用域。如果当前主题的 .sublime-color-scheme 文件里没有匹配这条 scope 的 rule，那它就永远用 fallback 颜色（通常是浅灰）——再调 background 也白搭。
- 优先选已知支持高对比的社区主题，比如
Brogrammer、Neon，它们的rules显式覆盖了keyword、string.quoted、comment.line等常见 scope - 别直接改
Packages/Color Scheme - Default/下的文件，那些是只读的；必须复制到Packages/User/下再编辑 - 改完后务必在用户设置中显式指定路径：
"color_scheme": "Packages/User/Brogrammer Custom.sublime-color-scheme"，否则 Sublime 仍加载原版
自定义语法高亮颜色必须绑定 scope，不能靠猜
想把 Python 的 def 改成深蓝，但改了 keyword 却没生效？大概率是因为 Python 实际用的是 keyword.control.python，而你只写了 "scope": "keyword"。Sublime 匹配 scope 是精确前缀匹配，keyword 不会命中 keyword.control.python。
正确做法是：先用 Show Scope Name 确认真实 scope，再往 rules 里加对应项。比如：
{
"name": "Python def",
"scope": "keyword.control.python",
"foreground": "#0044aa"
}
注意逗号分隔，JSON 格式要合法，编码保存为 UTF-8。常见易错 scope：
-
string.quoted.double（双引号字符串），不是string -
comment.line.number-sign（Python 的#注释），不是comment -
variable.parameter（函数参数），常被忽略，但影响可读性
highlight_line 高亮失效，90% 是因为 theme 没定义 region.line
开了 "highlight_line": true 却没反应，不是设置没生效，而是当前配色方案压根没定义 region.line 这个 scope 的背景色。Sublime 只负责“画”，不负责“配色”——它只渲染 region.line，但颜色由 .sublime-color-scheme 决定。
解决办法只有两个：换主题，或手动加 rule。推荐后者，可控性强：
- 在
Packages/User/下你自己的.sublime-color-scheme文件中，找到"rules"数组末尾 - 插入这一条（注意前面逗号）：
{"name": "Current Line", "scope": "region.line", "background": "#f0f0f0"} - 值用十六进制或
hsla()都行，但 alpha 值建议控制在 0.1–0.25 之间，太浓会干扰代码阅读
别指望 UI 主题（.sublime-theme）能管代码区高亮，它只影响菜单、标签栏这些非编辑区域。
自定义语法文件（.sublime-syntax）和 color_scheme 必须协同工作
写了新语法文件，比如 MyLang.sublime-syntax，也设了 scope: source.mylang，但高亮还是灰的？问题不在语法文件，而在 color_scheme 没响应这个 scope。
Sublime 的高亮流程是：语法文件 → 分配 scope → color_scheme → 渲染颜色。三者缺一不可。常见断点：
- 语法文件里
scope写成source/mylang（斜杠错），应为source.mylang - color_scheme 的
rules里没写"scope": "source.mylang"，导致整块代码用 fallback 颜色 - 用了第三方主题包（如
Material Theme），但它默认不支持你自定义的 scope，得自己补 rule
最稳的调试路径：先确保 Show Scope Name 能打出 source.mylang，再确认 color_scheme 里有对应 rule，最后检查 foreground 值是否可读——三步缺一不可。
