必须用ctrl+shift+p执行developer: show scope name，查看状态栏显示的完整scope链，取最右侧精确值（如keyword.control.mylang）；scope区分大小写，若只显示source.mylang说明语法规则未命中，需检查正则或file_extensions。
怎么确认自定义语法的 scope 名称
自定义语法（.sublime-syntax）生效后，关键字、字符串等元素的颜色不是由语法文件直接决定的，而是靠它赋予的 scope 值，再由配色方案（.sublime-color-scheme）匹配渲染。所以第一步必须查准 scope——否则改了颜色也看不到效果。
打开一个用你自定义语法高亮的文件，把光标停在目标词上（比如你定义的 mykeyword），按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入并执行 Developer: Show Scope Name。底部状态栏会显示一串 scope，例如：source.mylang keyword.control.mylang。其中最末尾那个（如 keyword.control.mylang）才是你要在配色方案里匹配的精确 scope。
- 别写成
keyword.control或keyword——少一级就匹配失败 - scope 区分大小写，
source.mylang和source.MYLANG是两个不同 scope - 如果只看到
source.mylang，说明你的语法规则没正确命中内容，得回头检查match正则或file_extensions是否拼错
怎么在 color_scheme 里为自定义 scope 设颜色
配色方案不会自动识别你新定义的 scope，必须手动加 rule。先确保你正在编辑的是 Packages/User/ 下的配色方案文件（不是只读的系统主题），并在用户设置中显式指定了 "color_scheme": "Packages/User/xxx.sublime-color-scheme"。
打开该 .sublime-color-scheme 文件，在 "rules" 数组里添加对象：
{
"name": "MyLang keyword",
"scope": "keyword.control.mylang",
"foreground": "#FF6B6B"
}
-
scope字段必须和Show Scope Name看到的完全一致 - 多个相关 scope 可合并写，用空格分隔：
"scope": "keyword.control.mylang constant.numeric.mylang" - 不支持正则匹配，
keyword.*.mylang这种写法无效 - 如果用了
background，注意别和行高亮（lineHighlight）或选中色冲突，导致文字不可读
为什么改了 color_scheme 还是没变色
常见失效原因不是配置错，而是路径或加载机制被忽略：
- 配色方案文件没放在
Packages/User/目录下——Sublime 只读取这里的内容 - 用户设置里漏写了
"color_scheme"行，或路径写成packages/user/（小写、反斜杠） - 语法文件保存后没生效：检查是否保存为
Packages/User/mylang.sublime-syntax，且文件名不含空格或中文 - 当前文件没真正应用该语法：右下角状态栏显示的是
Plain Text或别的语言，需右键 →Open all with current extension as…手动绑定 - 有插件（如 ApplySyntax）劫持了语法选择逻辑，临时禁用可验证
怎么让注释、字符串等通用元素带自定义前缀
如果你希望自定义语法里的注释也区别于 JavaScript 的注释（比如都标为 comment.line.mylang），不能只依赖默认继承。必须在 .sublime-syntax 的 contexts 里显式定义：
contexts:
main:
- match: '#.*$'
scope: comment.line.number-sign.mylang
- match: '"[^"]*"'
scope: string.quoted.double.mylang
- scope 后缀加
.mylang是关键，否则会和其它语言共用同一 scope，颜色就混了 - 别省略
main:层级，YAML 缩进错误会导致整个语法加载失败，且 Sublime 不报错 - 测试时用
Ctrl+Alt+P（Windows/Linux）或Cmd+Opt+P（macOS）快速查看当前 scope，比反复保存重试快得多
配色方案里加 rule 很简单，难的是确保 scope 从语法定义开始就干净、唯一、可追踪——一旦 scope 污染（比如多个语法都往 keyword 上打），后面所有颜色调整都会互相干扰。
