Sublime Text 4自定义YAML特定属性语法高亮问题求助

我正在编写大量OpenAPI规范的YAML文件，里面有一些给文档生成脚本用的自定义属性（比如@xtra开头、@template_开头的属性），想给这些属性设置专属颜色，方便在代码里快速识别。

我试着扩展Sublime Text的YAML语法高亮规则，但没生效（颜色完全没变化），以下是我的配置，麻烦帮忙找出问题：

自定义YAML语法文件（.sublime-syntax） #

%YAML 1.2
---
name: YAML custom
scope: source.yaml
version: 2.1

file_extensions:
  - yaml
  - yml

extends: Packages/YAML/YAML.sublime-syntax

contexts:
  custom-xtra:
    - match: '(\@xtra(\w)*)'
      scope: custom.extra.yaml
    - match: '(\@template_(\w)*)'
      scope: custom.extra.yaml

颜色方案配置（.sublime-color-scheme） #

{
    "name": "YAML custom",
    "scope": "custom.extra.yaml",
    "foreground": "Turquoise"
},

你的配置有两个关键问题：

1. 自定义语法规则未接入YAML识别流程 #

你定义了custom-xtra上下文，但没把它添加到YAML原生的语法上下文（比如识别键名的key上下文）里，导致Sublime根本不会触发这个匹配规则。

修改.sublime-syntax文件，将自定义上下文注入到key上下文：

%YAML 1.2
---
name: YAML custom
scope: source.yaml
version: 2.1

file_extensions:
  - yaml
  - yml

extends: Packages/YAML/YAML.sublime-syntax

contexts:
  key:
    - include: custom-xtra
    - include: Packages/YAML/YAML.sublime-syntax#key

  custom-xtra:
    - match: '@xtra\w*'
      scope: custom.extra.yaml
    - match: '@template_\w*'
      scope: custom.extra.yaml

这里把custom-xtra放在key上下文最前面，确保自定义规则优先匹配，同时简化了正则表达式（去掉多余括号，不影响匹配结果）。

2. 颜色方案格式错误 #

你贴的颜色配置只是单个规则片段，完整的.sublime-color-scheme文件需要是包含rules数组的JSON对象。正确写法如下：

{
    "name": "YAML Custom Colors",
    "author": "Your Name",
    "rules": [
        {
            "name": "YAML Custom Extra Properties",
            "scope": "custom.extra.yaml",
            "foreground": "#4ECDC4" // Turquoise对应的十六进制值，用这个比直接写颜色名兼容性更好
        }
    ]
}

如果是在现有颜色方案里加规则，直接把这个规则对象放进rules数组即可，不用单独拎出来。

最后确认：

• 修改后的.sublime-syntax文件要放在Sublime Text/Packages/User/目录下
• 颜色方案文件同样放User目录，或者在你正在用的颜色方案里添加规则
• 重启Sublime Text后打开YAML文件测试效果

内容的提问来源于stack exchange，提问作者sebeiron