必须安装Nginx语法包才能实现正确高亮，推荐nginx-sublime-syntax、nginx-conf或Nginx；需通过Syntax Specific按路径模式（如conf.d/*.conf）精准关联，而非全局绑定.conf扩展名。
安装 Nginx 语法包是前提，不是可选项
Sublime Text 默认把 .conf 当作 INI 或纯文本处理，server、upstream、proxy_pass 全都不高亮，括号不配对、缩进无提示——这不是你配置错了，是根本没加载 Nginx 语法规则。
必须通过 Package Control 安装专用语法包，推荐三个已验证可用的（截至 2026 年 1 月）：
-
nginx-sublime-syntax（社区活跃，支持最新 Nginx 1.25+ 指令和变量语法） -
nginx-conf（轻量，仅含核心规则，适合低配机器） -
Nginx（作者 bradleyg，老牌稳定，但更新稍慢）
安装后无需重启，但右下角仍显示 “Plain Text” 是正常现象——语法包只是“备好了”，还没“派上用场”。
手动切换语法只能临时生效
打开一个 /etc/nginx/nginx.conf，点击右下角当前语法名 → 选 Nginx（或 Nginx Conf），立刻高亮。但这只影响当前文件，关掉重开又变回纯文本。
常见错误操作：
- 点右下角后选
Open all with current extension as… → Nginx：这会把所有.conf强制绑定到 Nginx，导致redis.conf、haproxy.cfg（也常带 .conf）全乱套 - 在 Settings – Syntax Specific 里直接写
"extensions": ["conf"]：同样全局污染，不可取
真正安全的做法是按路径模式匹配，只对 Nginx 自己的配置路径生效。
按路径精准关联语法（推荐方案）
进入 Preferences → Settings – Syntax Specific，在右侧面板粘贴以下内容（注意路径需与你实际安装的包一致）：
{
"syntax": "Packages/nginx-sublime-syntax/nginx-sublime-syntax.sublime-syntax",
"extensions": [
"nginx.conf",
"conf.d/*.conf",
"sites-available/*",
"sites-enabled/*",
"stream/*"
]
}
说明：
-
Packages/nginx-sublime-syntax/nginx-sublime-syntax.sublime-syntax是该插件的实际路径，可通过Preferences → Browse Packages…进入对应文件夹确认是否存在同名.sublime-syntax文件 - 如果装的是
nginx-conf，路径应为Packages/nginx-conf/nginx-conf.tmLanguage -
stream/*是为 Nginx 1.9+ 的 stream 模块配置预留，若不用可删
保存后，只要文件路径匹配（如 /etc/nginx/sites-enabled/default），打开即自动启用高亮，其他 .conf 文件完全不受影响。
验证是否真生效，别信“看起来像”
高亮不是颜色多就对了，关键看三处：
-
server、location、upstream应为关键字色（通常是蓝色） -
proxy_pass、fastcgi_pass等指令值应有独立着色（如绿色或青色） - 大括号
{ }鼠标悬停或光标靠近时，能实时高亮配对位置
如果只有关键词变色但括号不匹配、缩进不自动对齐，大概率是语法包未正确加载，或路径写错——此时回到 Browse Packages… 确认插件目录是否存在、文件名是否拼写准确，比反复改 Settings 更有效。
最易被忽略的一点：Sublime 的语法识别是路径敏感的，不是内容敏感的。它不会读你文件里有没有 http { 才决定用什么高亮，而是严格按你写的路径 glob 规则匹配。所以命名规范（如把自定义配置放 conf.d/ 下）本身就是在帮编辑器工作。
