sublime 的 nginx 高亮仅做静态词法分析，不解析语法逻辑；必须用 nginx -t 验证配置，高亮颜色不可替代测试。
Sublime 本身不解析 Nginx 配置逻辑，只做静态词法高亮；nginx -t 才是验证语法和语义的唯一方式。高亮颜色不能代替配置测试，尤其在写 location ~*、map 块或 js_import 时，灰色变量或操作符是正常现象，不是插件失效。
怎么确认 nginx-sublime-syntax 插件已装好且路径正确
右下角显示 “Plain Text” 不代表插件没装——这是 Sublime 的默认行为，插件只是“备好了”，还没被调用。关键看三点：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: List Packages，列表里必须有nginx-sublime-syntax（首选）、nginx-conf或Nginx（作者 bradleyg）之一 - 进入
Preferences → Browse Packages…，检查对应目录下是否存在.sublime-syntax文件，例如Packages/nginx-sublime-syntax/nginx-sublime-syntax.sublime-syntax - 如果只看到
nginx-conf但没.tmLanguage或.sublime-syntax，说明安装不完整，建议重装或手动补全
为什么不能直接用 "extensions": ["conf"] 全局绑定
全局扩展名绑定会污染其他配置文件：redis.conf、logrotate.conf、haproxy.cfg、setup.cfg 甚至 .gitconfig 都可能被强行套上 Nginx 高亮规则，导致关键词错乱、缩进异常、括号匹配失效。
- Sublime 的语法系统不支持“按内容区分上下文”，
.conf是通用后缀，不能靠后缀判断语义 -
"extension": ["conf"]（少个 s）会静默失效，不报错也不生效 - 即使绑成功，
server_name ~^www.(.+)$里的~^和.依然灰色——这不是 bug，是词法分析器不处理正则上下文
如何让 /etc/nginx/conf.d/*.conf 自动高亮
这才是生产环境最稳妥的做法：只对真实 Nginx 配置路径生效，不碰其他 .conf 文件。操作路径是 Preferences → Settings – Syntax Specific，在右侧粘贴如下 JSON（注意路径与你安装的插件严格一致）：
{
"syntax": "Packages/nginx-sublime-syntax/nginx-sublime-syntax.sublime-syntax",
"file_name_patterns": [
"/etc/nginx/.*",
"/usr/local/etc/nginx/.*",
"nginx\.conf",
"sites-.*\.conf",
"conf\.d/.*\.conf"
]
}
-
file_name_patterns匹配的是**完整文件路径**，不是仅文件名；点号必须转义为\. - Windows 用户必须用正斜杠
C:/nginx/conf/nginx.conf或双反斜杠C:\nginx\conf\nginx.conf；单反斜杠会被解析为转义符，导致高亮崩溃 - 这个配置只对当前打开的文件类型生效；要让它覆盖整个目录，需先打开一个
/etc/nginx/conf.d/test.conf文件，再进 Settings – Syntax Specific 粘贴保存
server_name 里的正则和 $arg_foo 为什么还是灰色
这不是你配错了，是 Sublime 语法高亮的能力边界：它只做静态词法分析，不做上下文解析。
-
server、location、proxy_pass能着色，因为它们是关键字；但~^在server_name后是正则前缀，在if块里可能是字符串，语法定义无法动态切换 -
$arg_foo在if块里可能有基础高亮，但在map块里基本不染色——因为语法没覆盖该嵌套层级 - 依赖颜色判断变量或正则是否写对？别信。
nginx -t才是唯一权威，高亮只是辅助，不是验证手段
真正容易被忽略的点是：高亮规则生效的前提是路径匹配成功，而路径匹配依赖完整路径字符串；如果你用相对路径打开配置文件（比如直接双击桌面的 nginx.conf），file_name_patterns 里的 /etc/nginx/.* 就完全不触发——此时得加一条 "nginx\.conf" 这样的文件名正则。
