PackageDev 命令已改为 New Color Scheme – tmTheme,需输入全称;.tmTheme 中 background 为黑是因被 UI 主题覆盖;scope 匹配需语法定义支持且大小写精确;缓存未清会导致配色不刷新,应删 Cache 并 Reload Syntax Definitions。

PackageDev 装了但 New Color Scheme 不出现?
不是插件没装好,是命令名变了。Sublime Text 4 中 PackageDev 的命令已从旧版的 New Color Scheme 改为 New Color Scheme – tmTheme(带破折号和格式后缀)。按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS),输入时必须打全称,只输 “New Color Scheme” 会匹配不到。
常见错误现象:Ctrl+Shift+P 后输完回车,无反应、没新标签页、控制台也没报错——大概率就是命对不上。
- 确认插件已启用:打开
Preferences → Package Settings → PackageDev,有菜单说明已加载 - 手动验证命令是否存在:在控制台(
Ctrl+`)执行sublime.log_commands(True),再调一次命令面板,看输出里有没有new_color_scheme_tmtheme - 若仍不出现,重装
PackageDev:先Package Control: Remove Package,再重新安装
生成的 .tmTheme 模板里 background 总是黑的?
默认模板写的是 "background": "#000000",但 Sublime 实际渲染时会叠加 UI 主题(如 Adaptive、Soda)的背景色,导致你改了配色方案却看不出变化。这不是模板问题,而是作用域覆盖顺序没理清。
真正生效的背景色由两层决定:一是 .tmTheme 里的 settings 全局项,二是当前 UI 主题(Theme - Default.sublime-theme 或第三方主题)的 class 定义。UI 主题优先级更高。
- 临时验证:把
"background"改成亮色如"#ff0000",保存后Ctrl+Shift+P → Reload Syntax Definitions,如果还是黑,说明被 UI 主题盖住了 - 可靠做法:不要动
background,改"foreground"和"selection"等文本相关项,它们不受 UI 主题干扰 - 想彻底控制背景?换用纯色 UI 主题(如
Default Dark.sublime-theme),或直接编辑 UI 主题文件(风险高,不推荐初试)
rules 里 scope 写 entity.name.tag.xml 没效果?
XML 语法本身不提供细粒度 scope,entity.name.tag.xml 是通用 fallback,不会区分 和 。想让 Solr 特有标签着色,必须靠专用语法定义(.sublime-syntax)打上自定义 scope,比如 entity.name.tag.solr。
直接往 .tmTheme 的 rules 里加 "scope": "entity.name.tag.xml" 是徒劳的——因为 XML 默认根本不产生这个 scope。
- 先确认当前文件用了什么语法:右下角点击语法名,必须是
SolrConfig(不是 XML),否则 scope 根本不会生成 - 验证 scope 是否真实存在:光标停在
上,Ctrl+Shift+P → Developer: Show Scope Name,看到entity.name.tag.solr才算成功 - scope 名写错一个字母(如
solr写成solr_)就完全不匹配,.tmTheme里不会报错,只会静默失效
保存后配色不刷新,重启也不行?
Sublime 缓存的是语法和配色方案的编译结果,不是简单 reload 就能清掉。尤其当你从 Packages/Default/ 复制模板改名到 Packages/User/ 时,旧缓存可能还锁着原路径。
最干净的刷新方式不是重启编辑器,而是强制重建缓存并重载所有定义。
- 先删掉缓存目录:
Packages/User/MyTheme.tmTheme保存后,去Data/Cache/(路径见Preferences → Browse Packages…上级目录)删掉整个Cache文件夹 - 再执行
Ctrl+Shift+P → Reload Syntax Definitions,比单纯重启更彻底 - 如果用的是 symlink(比如 macOS 用 ln -s 指向外部目录),Sublime 会跳过缓存更新,必须用真实路径存放
.tmTheme
scope 匹配和缓存刷新是两个独立环节,容易混淆。先确保 scope 存在,再确保配色规则能读到它——漏掉任一环,颜色都不会变。











