Sublime Text 语法高亮优先级由加载顺序、scope匹配和first_line_match权重决定；需通过Open all with current extension as…绑定、修改User下.sublime-syntax文件或项目级.sublime-project配置来强制指定。
如何让 Sublime Text 优先使用某个语法高亮方案
Sublime Text 默认按文件扩展名匹配语法，但常遇到 .js 被识别成 JavaScript (Babel)、.md 被识别成 Markdown Extended 等情况——这不是 bug，是语法包注册顺序决定的优先级。真正起作用的是 scope 匹配规则和 first_line_match 的权重，不是“手动拖拽排序”。
- 语法高亮优先级由
Package Control安装顺序、.sublime-syntax文件中file_extensions和first_line_match的定义共同决定 - 修改
file_extensions不会覆盖已有映射，必须通过View → Syntax → Open all with current extension as…手动绑定一次，该绑定会写入Preferences.sublime-settings的extensions字段 - 若多个语法都声明了同一扩展名（如
JavaScript和JavaScript (Babel)都含js），Sublime 会选择最后加载的那个——通常就是最新安装或重命名后路径更靠后的包
修改 .sublime-syntax 文件强制接管文件类型
直接改语法定义文件是最彻底的方式，适用于你明确知道哪个包在“抢”高亮权。比如想让所有 .ts 文件强制走官方 TypeScript 而非 TypeScriptReact：
- 用
PackageResourceViewer: Open Resource找到目标语法文件（如TypeScript/TypeScript.sublime-syntax） - 复制整个内容，在
Packages/User/下新建同名文件（如TypeScript.sublime-syntax），Sublime 会自动优先加载User下的版本 - 在
file_extensions列表里补全你想接管的扩展名，例如追加- tsx（注意缩进为两个空格） - 删掉或注释掉
first_line_match（用#行注释），避免被 shebang 或#!/usr/bin/env node类行干扰匹配
file_extensions: - ts - tsx - d.ts # first_line_match: ^(#!.*\bnode\b|import\s+type)
为什么改了 syntax 文件还是不生效
常见失效原因不是语法写错，而是 Sublime 的缓存和作用域叠加机制在“暗中干预”：
-
View → Show Scope Name（快捷键Ctrl+Shift+P输入show scope）能实时看到当前光标处实际生效的scope，比如显示source.js.jsx就说明已被React JSX语法接管，哪怕文件后缀是.js - 某些插件（如
EditorConfig、SublimeLinter）会在加载时主动调用set_syntax()，覆盖你的设置；可临时禁用这些插件验证是否冲突 -
Packages/User/下的语法文件若存在语法错误（比如 YAML 缩进错位、漏了-），Sublime 会静默降级回用原包，且不报错——建议用YAML插件校验格式
绕过语法包冲突的轻量方案：用 .sublime-project 绑定
不想动全局配置或语法文件？项目级绑定更安全，尤其适合团队协作或临时切换场景：
- 菜单
Project → Save Project As…保存为xxx.sublime-project - 编辑该文件，在
folders同级加入settings块：
{
"folders": [
{ "path": "." }
],
"settings": {
"extensions": {
"js": "Packages/JavaScript/JavaScript.sublime-syntax",
"ts": "Packages/TypeScript/TypeScript.sublime-syntax"
}
}
}这个 extensions 映射只对当前项目生效，且优先级高于全局 Preferences.sublime-settings 中的同名字段。
最易忽略的一点：Sublime 的语法优先级本质是“谁最后注册、谁最细粒度、谁最先匹配”，而不是谁名字更靠前。改完别忘了重启 Sublime 或执行 Preferences → Browse Packages… → User → right-click → Reload Package 触发重载。
