Sublime Text的文件后缀语法绑定必须写在语法专属配置文件（如TypeScript.sublime-settings）中，而非全局Preferences.sublime-settings；该文件需位于Packages/User/目录下，名称须与目标语法完全一致，且内容为合法JSON格式的{"extensions": ["ts"]}。
语法绑定配置不写在 Preferences.sublime-settings 里
很多人以为改全局 Preferences.sublime-settings 就能绑定文件后缀和语法，结果加了 "extensions": ["ts"] 没反应——因为 Sublime 不认这个字段放在全局设置里。它只在「语法专属配置文件」中生效，比如 TypeScript.sublime-settings 或 INI.sublime-settings。
这类文件必须放在 Packages/User/ 目录下，且文件名要和你目标语法的名称完全一致（大小写、空格、点都不能错）。例如你想让 .env 文件默认用 INI 语法，就得确保存在 Packages/User/INI.sublime-settings，而不是随便起个名。
- 别手动新建：通过菜单 View → Syntax → Open all with current extension as… 触发一次，Sublime 会自动生成正确命名和路径的文件
- 如果已装 Babel 插件但
.jsx还是 Plain Text，先点右下角 → 选 JavaScript (Babel) → 再选 Open all with current extension as…，它才会往JavaScript (Babel).sublime-settings里写"extensions" - 文件内容必须是合法 JSON，且只允许一个顶层对象：
{ "extensions": ["jsx", "tsx"] }，多一个逗号或少一个引号都会导致整个文件被忽略
如何找到某个语法的真实路径？
语法绑定时 "syntax" 字段的值不是随便写的名称，而是完整路径，比如 "Packages/INI/INI.sublime-syntax"。写错就完全不生效，且没有任何提示。
最稳的方式不是猜，而是查：打开一个已正确高亮的文件（比如用 INI 语法打开的 .env），然后按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Developer: Show Scope Name，看输出里类似 source.ini 的 scope 名；再用 PackageResourceViewer 插件（没装就先装）→ PackageResourceViewer: Open Resource → 找到 INI 包 → 选 INI.sublime-syntax，就能看到它的实际路径。
- 路径区分大小写：
Packages/ini/ini.tmLanguage和Packages/INI/INI.sublime-syntax是两个东西 - 旧式
.tmLanguage和新式.sublime-syntax文件共存时，优先加载后者；但如果你的插件只提供前者（比如老版 nginx-conf），就得用对应路径 - Windows 下路径用正斜杠
/更安全，反斜杠容易被当成转义符，导致语法加载失败
nginx.conf 这类路径型绑定为什么不能靠扩展名？
直接给 .conf 绑定 Nginx 语法会导致 redis.conf、logrotate.conf 全部套上 Nginx 关键字着色，这是典型的语义污染。Sublime 的语法系统不支持“同扩展名不同上下文”，所以必须用 file_name_patterns 做路径级匹配。
这种配置只能写在语法专属设置里，比如 nginx-sublime-syntax.sublime-settings，内容类似：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
{
"syntax": "Packages/nginx-sublime-syntax/nginx-sublime-syntax.sublime-syntax",
"file_name_patterns": [
"/etc/nginx/.*",
"nginx\.conf",
"conf\.d/.*\.conf"
]
}
注意 . 必须写成 \.，否则正则会把 .conf 当作“任意字符 + conf”来匹配。
-
file_name_patterns优先级高于extensions，只要路径匹配，哪怕后缀是.txt也会强制用该语法 - 路径是正则，不是 glob；
*在正则里无意义，得用.* - Mac/Linux 路径用
/，Windows 可以用/或\\（双反斜杠），单必崩
插件自带的语法文件被覆盖或失效怎么办？
有些插件（比如 TypeScript）会自带 .sublime-syntax 文件，但你手动改了 Packages/TypeScript/ 下的文件，升级插件时会被重置——这不是 bug，是设计如此。用户层修改必须走 Packages/User/ 下的专属配置，而不是动插件源码。
如果你发现某语法突然不亮了，先检查三件事：
- 进
Preferences → Browse Packages…，确认对应插件文件夹里真有.sublime-syntax或.tmLanguage文件，空文件夹=安装失败 - 打开控制台（
Ctrl+`），执行view.settings().get('syntax')，看返回的是不是你预期的路径；如果是None或空字符串，说明语法根本没加载 - 执行
sublime.log_commands(True)，再点右下角切换语法，观察控制台是否输出set_syntax_file日志；没输出=点击没触发，可能是 UI 被其他插件劫持
真正需要改底层语法定义（比如加一个新 token）时，应该复制原始 .sublime-syntax 到 Packages/User/ 下重命名（如 TypeScript-Modified.sublime-syntax），再在 TypeScript.sublime-settings 中指向它——而不是直接覆盖原文件。
