Sublime Text远程编辑仅两种有效路径：SFTP插件同步（推荐多数场景）或rsub反向隧道（适合临时单文件）。SFTP基于本地编辑+自动同步，兼容性好；rsub依赖SSH反向端口转发，链路脆弱但延迟低。
Sublime Text 不能直接通过 subl user@host:/path 打开远程文件——这是内核限制，不是配置没到位。真正可用的远程编辑只有两种路径：SFTP 插件同步（推荐多数场景），或 rsub 反向隧道（适合临时、单文件快速编辑）。选错方案会卡在“打不开”“无响应”“空文件”上。
为什么 SFTP 插件是默认首选
SFTP 插件本质是「本地编辑 + 自动同步」，不依赖远程 Sublime 进程，兼容性好、配置一次长期有效，且支持目录映射、忽略规则、自动下载最新版等实用功能。
-
sftp-config.json必须放在项目根目录下（不是随便哪个文件夹），且文件名不能改；Sublime 不会从子目录或全局位置读取它 -
remote_path必须写绝对路径，"~/project"会被当字面量处理，最终访问的是/home/user/~/project，导致连接成功但列表为空 - 启用
sync_down_on_open后，首次打开文件时会拉取服务器版本——但如果服务器文件权限为600且用户非 owner，可能静默失败，建议先用ssh登录确认cat /path/to/file是否可读 - 密码明文写在配置里不安全，优先用
ssh_key_file，路径必须是绝对路径，~/.ssh/id_rsa无效，得写成/home/yourname/.ssh/id_rsa
Map to Remote 和 Setup Server 的区别在哪
二者生成的都是 sftp-config.json，但触发方式和上下文不同，直接影响配置是否生效。
-
Map to Remote：右键本地项目文件夹调用，自动生成配置并绑定该文件夹路径到
folders.path，后续所有同步操作都以此为基准，upload_on_save才能正确识别哪些文件该传 -
Setup Server：菜单栏
File → SFTP → Setup Server，生成的是独立配置文件，不关联任何本地路径，容易变成“配了但不起作用” - 如果用了
Map to Remote，但保存后没上传，先检查sftp-config.json里"folders": [{ "path": "..." }]的值是否与当前项目实际路径一致（Windows 路径斜杠方向、空格转义都要对）
rsub 反向隧道为什么总连不上
rsub 不是“连服务器”，而是让远程命令反向触达本地 Sublime，链路更脆弱，但延迟低、适合调试日志类只读文件。
- 远程执行
rsub filename前，必须已建立 SSH 反向隧道：ssh -R 52698:localhost:52698 -Nf your_local_user@your_local_ip；-Nf很关键，否则隧道随终端退出而断 - 本地 Sublime 必须已安装
rsub插件，且状态栏右下角显示rsub: ready；重启 Sublime 后插件才加载，不热重载 - 远程执行
rsub时若目标文件需 root 权限（如/var/log/nginx/access.log），必须加sudo rsub /path，否则 Sublime 收到空内容 - 防火墙常拦 52698 端口，尤其是 macOS 默认开启防火墙，需手动放行或换端口并在
rsub插件设置中同步修改
最易被忽略的一点：SFTP 配置改完后不重启 Sublime，插件不会重新读取 sftp-config.json；rsub 插件启用后不看状态栏提示，就无法确认监听是否就绪。这两个动作看着多余，实则是成败分界线。
