Sublime Text 编辑远程文件需依赖插件，推荐SFTP插件（全平台、稳定、免额外依赖），配置须设"upload_on_save": true、用ssh_key_file而非明文密码、remote_path末尾不加斜杠；rsub方案限制多，需正确配置SSH反向端口转发且仅适用于Linux/macOS。
Sublime Text 本身不支持直接 SSH 编辑远程 Linux 文件，必须靠插件或桥接工具实现。主流可靠方案只有两个：SFTP 插件（推荐）和 rsub（Ruby 实现，限制多）。别信“内置 SSH 支持”这类说法——它根本不存在。
用 SFTP 插件编辑远程文件最稳，但配置容易漏关键项
SFTP 是目前 Sublime 上最成熟、兼容性最好、Windows/macOS/Linux 全平台可用的方案。它走标准 SSH 协议，不依赖 Ruby 或额外守护进程，出问题也容易定位。
- 安装后必须通过 右键侧边栏文件夹 → SFTP > Map to Remote… 生成配置，而不是只用
Setup Server；后者只建连接，不绑定本地目录，保存不会自动上传 - 配置里
"upload_on_save": true必须显式设为 true，默认是false，否则改完 Ctrl+S 完全没反应 - 密码明文写进配置极不安全，优先用
"ssh_key_file": "~/.ssh/id_rsa"；Windows 用户若用 PuTTY 密钥，得先用puttygen转成.ppk格式，路径填绝对路径如"D:\keys\server.ppk" - 如果远程路径是
/var/www/html，"remote_path"值末尾不能加斜杠（即写"/var/www/html"，不是"/var/www/html/"），否则浏览服务器时会报Invalid path
rsub 启动成功也不代表能用，SSH 端口转发是最大坑点
rsub 看起来轻量，但实际对环境要求苛刻：它本质是让远程的 Ruby 进程监听 127.0.0.1:52698，再靠 SSH 把这个本地端口“反向暴露”给 Sublime。只要转发链断一环，就卡在 Connecting… 或报 Connection refused。
- 远程执行
rsub后，必须确认它真的在跑：lsof -i :52698或netstat -tuln | grep 52698，输出应含127.0.0.1:52698；若显示*:52698，说明启动时加了--bind错误参数，得重跑 - 本地连远程的 SSH 命令必须是：
ssh -R 52698:localhost:52698 user@host；-R是对的，但语义不是“远程监听”，而是“把远程的 52698 绑定到我本地的 52698”——这是 SSH 的反直觉设计 - Mac 或 Linux 上 Sublime 找不到
rsub命令，大概率是启动 Sublime 时 shell 的$PATH没加载进 GUI 环境；临时解决：终端里运行open -a "Sublime Text"启动，而非点击图标 - Windows 用户基本不用试
rsub；WSL2 + X11 转发太重，且 Sublime for Windows 根本不调用 WSL 的PATH，which rsub永远失败
文件乱码、权限错、同步失败？先看这三处
很多“编辑不了”其实是编码或权限导致的静默失败，不是连接问题。
- 中文文件名/内容乱码：在
sftp-config.json中加"remote_encoding": "utf-8"，并确保远程 Linux 的 locale 是en_US.UTF-8或zh_CN.UTF-8（locale命令查看） - 保存后远程文件权限变成
600，网站打不开：配置里明确设"file_permissions": "644"和"dir_permissions": "755"，否则 SFTP 插件按 umask 默认行为处理 - 修改后不上传，或上传空文件：检查
"sync_down_on_open": true是否开启；若关了，首次打开是本地缓存副本，改完保存只会写本地，不会触碰远程
真正麻烦的不是选哪个方案，而是 SFTP 配置里一个逗号少写、rsub 的 SSH 转发少敲一个 localhost，就会让你卡半小时。建议第一次配好后，把完整配置和启动命令存成文本片段，下次直接复制粘贴。
