sublime text 不能直接远程编辑服务器文件，因其不支持 ssh/ftp 协议，依赖 sftp 等插件实现下载→编辑→上传的非实时同步机制，存在上传卡顿、无原子性、中文乱码等固有缺陷。
Sublime Text 能不能直接远程编辑服务器文件
不能。Sublime Text 本身不支持 SSH 或 FTP 协议，也没有内置的远程文件系统挂载能力。所谓“远程编辑”，实际是靠第三方插件模拟本地操作，底层仍是下载→编辑→上传的三步逻辑，不是实时双向同步。
这意味着：每次保存都会触发一次完整文件上传；大文件容易卡死或超时；没有原子性保障（比如上传中途断开，可能留下损坏文件）。
-
SFTP插件最常用，但本质是 FTP/SFTP 客户端，不是编辑器原生功能 -
SyncedSideBar或Remote-SSH类插件只是增强体验，不改变“本地缓存+手动同步”这一根本机制 - 真要低延迟、高可靠，得换 VS Code +
Remote-SSH扩展，或者用vim+sshfs挂载
SFTP 插件配置时最常见的连接失败原因
装完 SFTP 插件后点 Map to Remote 报错，90% 是配置项填错了位置或格式不对。它不读取系统 SSH 配置，也不自动复用 ~/.ssh/config，所有参数必须显式写进 sftp-config.json。
-
host填 IP 就行，别加ssh://前缀；user必须是服务器上真实存在的用户名 -
password和private_key二选一，不能同时存在；私钥路径必须是绝对路径，比如/Users/you/.ssh/id_rsa -
port默认是 22，如果改过 SSH 端口（比如 2222），这里必须显式写出来，否则连不上 - Windows 用户注意：
remote_path用正斜杠/，不是反斜杠\；路径末尾不要加/
典型错误信息：Connection refused → 端口错或服务没开；Permission denied (publickey) → 私钥没权限（chmod 600）、路径错、或服务器 sshd_config 关了公钥登录。
保存时自动上传 vs 手动上传，怎么选
在 sftp-config.json 里设 "upload_on_save": true 最省事，但风险也最集中——改错一行就立刻覆盖线上文件。尤其在生产环境，这等于裸奔。
- 开发机或测试环境可开，但建议加
"confirm_overwrite": true，避免误覆盖同名文件 - 线上环境务必关掉
upload_on_save，改用右键菜单SFTP → Upload File，手动控制时机 - 想保留历史版本？
SFTP不提供版本管理，得配合git在服务器上做；或者本地编辑完先git diff确认再上传 - 大文件（>10MB）上传容易失败，
"sync_down_on_open": false可避免打开就拉全量，只在需要时手动Download File
中文路径/文件名乱码怎么办
不是 Sublime 的锅，是 SFTP 协议层编码不一致导致的。服务器用 UTF-8，但某些旧版 OpenSSH 或 FTP 服务默认用 Latin-1，SFTP 插件又没强制声明编码，结果中文名变成 .txt。
- 优先改服务器：确认
locale输出含UTF-8，比如en_US.UTF-8；检查/etc/ssh/sshd_config有无AcceptEnv LANG LC_* - 插件侧补救：在
sftp-config.json加"charset": "utf-8"（仅部分版本支持，v3.4.0+ 有效） - 实在不行，绕开问题：服务器端用英文路径，本地用符号链接或项目映射，别让中文出现在远程路径里
这个坑藏得深——文件能正常编辑保存，只是目录树里显示异常，容易误判为 UI 问题，其实底层文件名已经损坏，后续脚本调用会失败。
