sublime text 不支持远程编辑，需依赖 sftp 插件或 rsync 方案；sftp 插件通过本地缓存+上传机制绕过系统挂载缺陷，配置需注意 host、user、upload_on_save、ssh_key_file 等字段及权限、编码、超时设置。
Sublime Text 本身不支持远程文件编辑——它没有内置的 SFTP、SSH 或 WebDAV 功能，所有“远程编辑”都依赖第三方插件或间接方案。
为什么直接双击远程路径会失败
Windows 资源管理器里映射的网络驱动器（如 Z:\）或 macOS 的挂载点（如 /Volumes/server），Sublime Text 可以打开，但修改保存时极易卡死、报错 Permission denied 或静默丢弃更改。根本原因是：这些挂载通常基于 SMB/CIFS，文件锁、缓存策略和 Sublime 的原子写入机制（先写临时文件再替换）严重冲突。
- 不要用 Finder/Explorer 挂载后直接拖进 Sublime —— 看似能开，实则高概率损坏文件
- Linux 下通过
sshfs挂载的目录稍好，但仍建议只读浏览，不用于日常编辑 - Sublime 的
File → Open...对远程 URL（如sftp://）完全无响应，这不是 bug，是设计如此
真正可用的方案只有两个：SFTP 插件 或 rsync + 本地编辑
前者是主流选择，后者适合对一致性要求极高的场景（比如编辑生产服务器上的 Nginx 配置）。SFTP 插件本质是把远程文件下载到本地缓存，编辑完再上传，全程由插件接管 IO，绕过了系统挂载层的坑。
- 必须装插件：
SFTP（Package Control 里搜，作者是wbond），不是FTPSync或其他名字近似的 - 配置文件是
SFTP.sublime-settings，关键字段："host"、"user"、"port"、"remote_path"；别漏掉"upload_on_save": true - 首次保存时会弹出配置向导，选 “SFTP Config File…” 自动生成，别手敲 JSON 容易少逗号
- 如果服务器禁用了密码登录，必须提前在
"ssh_key_file"指定私钥路径（如"~/.ssh/id_rsa"），且确保权限是600
常见错误现象和对应解法
连得上但改不了？保存没反应？上传后内容没变？这些问题几乎都出在路径或权限链路上。
- 错误信息
Connection refused：检查"port"是否写成字符串（应为数字，如22，不是"22"） - 编辑后保存，远程文件时间戳变了但内容没更新：确认
"upload_on_save"是true，且没被项目级配置覆盖（项目设置优先级高于用户设置） - 中文路径乱码或报错
UnicodeEncodeError：在配置里加"encoding": "utf-8"，并确保服务器 locale 支持 UTF-8（locale命令查） - 大文件（>10MB）上传超时：调大
"timeout"（单位秒，默认 30），同时确认服务器sshd_config里ClientAliveInterval足够长
最常被忽略的是：SFTP 插件不会自动同步远程删除或重命名操作——它只管“你本地改了什么，就传什么”。如果你在服务器上直接删了文件，Sublime 本地缓存还在，下次打开就是旧内容。真要双向同步，得换 rsync 脚本或者上 VS Code + Remote-SSH。
