Sublime Text语法匹配仅依赖扩展名，不分析文件内容；.env等未注册后缀默认为Plain Text，需手动绑定扩展名与语法，而非修改default_syntax。
语法匹配只看扩展名，不读文件内容
Sublime Text 打开文件时根本不会扫描内容来判断该用什么语法，它只检查文件后缀（如 .py、.js），然后查内置或用户配置的 file_extensions 列表。没匹配上就 fallback 到 Plain Text。这不是 bug，是设计如此——所以 .env、.conf、.yml 默认都是 Plain Text，不是识别失败，是压根没被注册。
常见错误现象：.env 文件右下角始终显示 Plain Text；点右下角菜单里找不到 Set as Default for .env Files 选项。
- 先手动点右下角 → 选
INI或ShellScript，让当前文件临时高亮 - 再点一次右下角 → 此时才会出现
Set as Default for .env Files - 点击确认后，Sublime 自动往
Packages/User/Preferences.sublime-settings写入{"extensions": ["env"]}，并关联到对应语法路径
给冷门后缀绑定语法，别改 default_syntax
default_syntax 只控制 Ctrl+N 新建的 untitled 文件，对任何带扩展名的已保存文件完全无效。想让 .env 或 .conf 自动高亮，必须走 extensions 映射，而不是在用户设置里写 "default_syntax": "Packages/INI/INI.sublime-syntax"。
Apache 的 httpd.conf 和 Nginx 的 nginx.conf 都是 .conf，但语法完全不同。硬把所有 .conf 绑定到 INI 会出问题。
- 正确做法：打开一个
nginx.conf→ 右下角选Nginx→ 再点右下角 →Open all with current extension as…→ 选Nginx - 这样只会为当前文件所在路径下的
.conf生效（部分插件支持路径感知）；更稳的是用 ApplySyntax 插件配file_name正则 - 若已装 ApplySyntax，默认规则极保守，不手动配等于没装。规则必须放在
syntaxes数组里，每个对象至少含"name"和"rules"
ApplySyntax 规则怎么写才命中
ApplySyntax 不是“智能识别”，只是按你写的 JSON 规则顺序匹配：路径 > 内容正则 > 扩展名，命中即停。默认规则几乎不生效，全靠自己补。
示例：让项目根目录下的 .env 文件，只要首行含 export 就用 ShellScript 高亮：
{
"rules": [
{
"file_name": "\.env$",
"first_line_match": "^export ",
"syntax": "ShellScript/Shell-Unix-Generic"
}
]
}
注意几个易错点：
-
file_name是正则，要转义点："\.env$"，不是".env" -
first_line_match只读第一行，不能跨行；想匹配多行内容得用head_match（需 ApplySyntax ≥ 3.0） -
syntax值必须是完整路径，如"Packages/ShellScript/Shell-Unix-Generic.sublime-syntax"，不能只写"ShellScript" - 改完配置必须重启 Sublime 才生效，很多人改完立刻测试，结果还在走旧规则
验证语法是否真正生效的关键动作
光看右下角显示“JavaScript”不代表配置已加载。Sublime 加载语法专属设置（如 JavaScript.sublime-settings）的前提是：当前视图的语法 scope 必须明确且稳定。
常见失效场景：shebang 行（#!/usr/bin/env node）让 Sublime 优先匹配 ShellScript；插件（如 Vue Syntax Highlight）覆盖了默认语法定义；或者你手动锁定了语法（右下角点过一次后它就不自动变了）。
- 验证方式：打开目标文件 → 按
Ctrl+Shift+P→ 输入Show Scope Name→ 看状态栏是否显示source.js或source.nginx这类带source.前缀的 scope - 如果显示
text.plain或source.unknown，说明语法未识别，任何语法专属设置都不会加载 - 快捷强制指定：
Ctrl+Shift+P→Set Syntax: JavaScript，比反复点右下角更可靠
