Sublime Text 需手动配置 Nginx 语法高亮与补全：安装 nginx-sublime-syntax 插件，右键设置 .conf 文件语法为 Nginx 并应用到所有 .conf 文件，确保 server、proxy_pass 等关键字正确着色；upstream 必须置于 http 块内，weight 在 ip_hash/least_conn 下失效，backup/down 非注释且每行须加分号；推荐用 AutoFileName 和自建 snippet 补全 proxy_pass 及 header；reload 失败常因 CRLF 换行或不可见 Unicode 字符，应统一设为 LF 编码并使用英文标点。
Sublime Text 本身不运行 Nginx，但它是写 nginx.conf 和 conf.d/*.conf 文件最顺手的编辑器之一——前提是配好语法高亮和补全。没配的话，upstream、proxy_pass 全是白字，缩进错乱、括号不匹配、拼错 proxy_set_header 都发现不了，等 nginx -t 报错才回头改，效率极低。
怎么让 .conf 文件自动识别 Nginx 语法？
Sublime 默认把 .conf 当作纯文本，必须手动绑定 Nginx 语法。这不是“装个插件就完事”，而是三步闭环：
- 用
Package Control → Install Package搜索并安装nginx-sublime-syntax（推荐）或sublimenginx - 打开任意
nginx.conf或/etc/nginx/conf.d/app.conf，右下角点击当前语法（如Plain Text）→ 选择Nginx - 为防下次打开又变回纯文本，右键文件 →
Set Syntax → Nginx，再点Apply to All Files with Extension ".conf"
验证是否生效：看到 server、upstream、location 变蓝，proxy_pass 变绿，大括号能高亮匹配，就对了。
写 upstream 负载均衡块时，哪些细节容易被忽略？
语法高亮只是基础，真正卡住人的往往是 upstream 块里那些“看不见的规则”：
-
upstream必须定义在http{...}块内，不能放在server{...}里面，否则nginx -t直接报unknown directive "upstream" -
weight值只在round-robin（默认）模式下生效；加了ip_hash或least_conn后，weight会被忽略 -
backup和down是状态标记，不是注释：写成# backup没用，必须是server 127.0.0.1:8081 backup; - 每行末尾不能漏分号，尤其是最后一行 ——
nginx -t会报unexpected end of file, expecting ";"
upstream backend_servers {
server 192.168.1.10:8080 weight=3;
server 192.168.1.11:8080 weight=2;
server 127.0.0.1:8081 backup; # ← 这里必须有分号
}怎么快速补全 proxy_pass 和 header 设置？
靠手敲 proxy_set_header X-Real-IP $remote_addr; 不仅慢，还容易拼错变量名（比如写成 $remote_ip）。推荐两个实操方案：
- 装
AutoFileName插件：输入include时自动提示路径，避免include /etc/nginx/conf.d/*.conf;写错路径 - 自建 snippet：按
Ctrl+Shift+P→Tools → Developer → New Snippet，粘贴以下内容并保存为proxy_pass.sublime-snippet
proxy_pass source.nginx ]]>
之后在 location / { } 里输入 proxy_pass + Tab，整套反向代理模板就出来了。
为什么 nginx -t 通过了，reload 却失败？
常见陷阱不在语法，而在 Sublime 的“隐藏行为”：
- Windows 用户用 Sublime 保存文件时，默认编码可能是
CRLF（回车换行），而 Linux 下 Nginx 要求LF；现象是nginx -t显示 OK，但systemctl reload nginx报invalid number of arguments in "server" directive等奇怪错误 -
解决方法：Sublime 右下角点击行尾标记（显示
CRLF）→ 改为LF→Save - 另一个坑：复制粘贴配置时带了不可见 Unicode 字符（比如中文引号、全角空格），
nginx -t有时不报，但 reload 失败；建议所有引号用英文半角，路径用单引号或不加引号
真正写 Nginx 配置，90% 的时间花在验证和调试上。Sublime 配得越贴近生产环境（LF 换行、正确语法、变量补全），你越早发现 upstream 少了个分号、proxy_pass 少了 http://，而不是等到用户打电话说“网站打不开”。
