Sublime Text 颜色方案生效需满足三要素:路径必须为 Packages/User/xxx.sublime-color-scheme,JSON 格式严格无注释、无 BOM、逗号引号正确,且 color_scheme 设置项须显式声明;修改 selection 或关键字颜色时,规则必须置于 "rules" 数组内并匹配精确 scope;theme 与 color_scheme 分属不同系统,需分别配置以统一视觉。

Linux 下 Sublime Text 的颜色方案不是“选完就生效”,关键在路径、格式、加载顺序三处卡点——改错位置或漏配 color_scheme,90% 的自定义都会静默失败。
怎么确认当前生效的 .sublime-color-scheme 文件路径
你看到的颜色没变,大概率是因为正在改一个 Sublime 根本没加载的文件。必须先定位真实路径:
- 按
Ctrl+Shift+P输入Show Scope Name回车,右下角状态栏立刻显示类似Packages/User/MyMariana.sublime-color-scheme的完整路径 - 如果路径里不含
Packages/User/(比如是Packages/Color Scheme - Default/Mariana.sublime-color-scheme),说明你在改只读系统文件——升级后必丢,且当前也未启用 - 此时必须:用
Preferences → Browse Packages…打开User目录,把原文件复制进去并重命名(如MyMariana.sublime-color-scheme),再在用户设置里加"color_scheme": "Packages/User/MyMariana.sublime-color-scheme"
为什么改了 selection 背景色还是看不见选中效果
selection 规则只控制鼠标拖选那块区域,它必须写在 .sublime-color-scheme 文件的 "rules" 数组里,其他任何位置都无效:
- 打开你的
.sublime-color-scheme文件,搜索"scope": "selection"或"name": "Selection" - 找到后直接改
background值:推荐用带 alpha 的hsla()(如"background": "hsla(210, 30%, 40%, 0.4)")或 6 位 hex(如"background": "#2a5c8a");纯#ff0000容易盖住语法高亮,文字看不清 - 如果整个文件里压根没有
selection条目,就在"rules"数组末尾手动加一段(注意 JSON 逗号和引号):{ "name":"Selection", "scope":"selection", "background":"#2a5c8a" } - 保存即生效,无需重启;若无效,先检查 JSON 是否有 BOM 头、多逗号、少引号
关键字/字符串颜色改不生效?八成是 scope 没对上
Sublime 不认“Python 的 def”,只认它被语法赋予的精确 scope,比如 keyword.control.python —— 写错一个字符或大小写,颜色就白改:
Linux 安全审计工具,检查 SSH 配置、开放/监听端口、防火墙规则(ufw/iptables/nftables)、失败登录尝试、sudoers 权限...
- 把光标停在想调色的关键字(如
return)上,按Ctrl+Shift+P→Developer: Show Scope Name,看状态栏末尾显示的完整 scope(如keyword.control.python) - 在你的
.sublime-color-scheme文件"rules"数组里搜索这个 scope 字符串,必须**完全一致**(包括大小写、点号、后缀) - 找不到就新增一条规则:
{ "name":"Python keyword", "scope":"keyword.control.python", "foreground":"#FF6B6B" } - 别写
keyword这种宽泛值,也不支持通配符(keyword.*.python无效)
侧边栏、标签页颜色和编辑区不统一?theme 和 color_scheme 是两套系统
color_scheme 只管编辑区代码,theme 才管侧边栏、标签页、状态栏——两者路径独立、互不干扰,缺一不可:
- 检查当前 theme:菜单
Preferences → Theme…,如果显示的是Adaptive.sublime-theme,那侧边栏就是纯黑,和任何柔和的color_scheme都割裂 - 要整体护眼,必须同步设 theme:按
Ctrl+Shift+P输入UI: Select Theme,选Material Theme或Ayu Mirage等第三方主题;或手动在用户设置里加"theme": "Material-Theme.sublime-theme" - 常见错误:
color_scheme设了Ayu Mirage,但theme还是Adaptive,结果编辑区柔和、侧边栏扎眼——眼睛真正疲劳的,往往就来自这种视觉断层
Linux 下最易被忽略的点:路径大小写敏感、JSON 文件不能有注释、Packages/User/ 必须全大写且斜杠方向为正斜杠(/),写成 packages/user/ 或 Packages\User\ 就会静默失败。










