Sublime Text 编辑远程 Nginx 配置需通过 SFTP 插件实现本地编辑+自动同步，关键在于正确配置 upload_on_save、sync_down_on_open、SSH 权限及语法高亮绑定，并严格检查换行符（LF）、隐藏字符和英文标点，上传后必须手动执行 sudo nginx -t 验证。
Sublime Text 本身不支持直接编辑远程文件，所谓“编辑远程 Nginx 配置文件”，实际是本地编辑 + 同步机制，关键在怎么让修改安全、实时、可验证——别等 nginx -t 报错才意识到换行符是 CRLF 或某处多了个不可见 Unicode 字符。
用 SFTP 插件同步 /etc/nginx/ 下的文件
这是最常用也最可控的方式：把远程配置拉到本地临时目录，编辑保存后自动上传。前提是已安装并正确配置 SFTP 插件（不是 FTP/Sync 这类弃用方案）。
- 确保远程服务器 SSH 可达，且你有
/etc/nginx/目录的读写权限（通常需 sudo 权限，SFTP 插件不支持交互式 sudo，得提前配好无密码 sudo 或改用 root 登录） - 在 Sublime 中右键项目根目录 →
SFTP→Map to Remote...，填入 host、user、port，并在remote_path填/etc/nginx/ - 关键配置项：
"upload_on_save": true必须为true；"sync_down_on_open": true推荐开启，避免本地缓存过期；"ssh_key_file"若用密钥登录，路径必须用正斜杠（Windows 也写C:/Users/xxx/.ssh/id_rsa） - 首次同步后，所有
.conf文件仍显示Plain Text—— 这不是失败，是语法还没绑定，需下一步操作
编辑时 server/upstream 仍是灰色？语法没绑对路径
即使装了 nginx-sublime-syntax，SFTP 拉下来的文件默认走本地路径规则，而 /etc/nginx/.* 这类正则只匹配真实本地路径，不会匹配 SFTP 映射后的虚拟路径（比如 project/nginx.conf）。必须手动适配。
- 打开一个刚同步下来的
nginx.conf，右下角点击Plain Text→Open all with current extension as...→ 选Nginx（若没这个选项，先确认插件已装且存在Packages/nginx-sublime-syntax/nginx-sublime-syntax.sublime-syntax） - 更稳妥的做法：进
Preferences → Settings – Syntax Specific，右侧粘贴如下（注意file_name_patterns匹配的是你本地看到的路径名，不是远程路径）：
{
"syntax": "Packages/nginx-sublime-syntax/nginx-sublime-syntax.sublime-syntax",
"file_name_patterns": [
"nginx\.conf",
"conf\.d/.*\.conf",
"sites-available/.*",
"sites-enabled/.*"
]
}
其中点号必须写成 .（JSON 字符串里要双转义），否则 .conf 会被当通配符误匹配。
保存后 nginx -t 失败？检查换行符和隐藏字符
Sublime 默认用 LF 换行，但若从 Windows 环境复制粘贴过配置，或用其他编辑器改过，可能混入 CRLF 或零宽空格（U+200B）。Nginx 解析时直接报 unexpected "}" 或 invalid number of arguments。
- 底部状态栏查看当前换行符类型：点击
LF或CRLF，强制设为LF - 菜单
View → Hidden Characters打开，检查是否有异常空格、零宽字符；也可用正则替换s+$清理行尾空白 - 关键指令如
proxy_pass http://backend;后面的分号不能少，且必须是英文标点——中文输入法下打的分号；会导致nginx -t直接失败 - 上传后立刻在终端执行
sudo nginx -t，别跳过这步。SFTP 上传成功 ≠ Nginx 能加载
真正容易被忽略的点：SFTP 的 upload_on_save 是异步的，快速连按 Ctrl+S 可能漏传；而 nginx -s reload 必须在 nginx -t 通过后手动触发，Sublime 不会代劳——别以为高亮全蓝、保存就万事大吉。
