Sublime如何连接远程服务器？使用Sublime SFTP插件同步代码教程
想用Sublime Text直接编辑服务器上的代码？这事儿本身它办不到。编辑器本身没有远程连接功能，必须借助一个叫做SFTP的插件来搭桥。但问题往往从这里开始——插件装好了，菜单却不出现，配置好像没加载，保存文件也不自动上传。其实，90%的坑都藏在项目绑定、配置文件路径和SSH认证这些细节里。
右键没 SFTP 菜单？先检查项目和文件夹状态
首先得明白，这个插件有点“认生”。它不会在所有地方都激活菜单，只会在一个“有效的项目”里，并且侧边栏明确显示了文件夹图标时，才会现身。如果你在空白处、单个文件上，或者一个没被添加到项目的目录里右键，是找不到它的。
- 关键第一步：通过菜单栏的 Project → Add Folder to Project，把本地的工作目录正式添加进项目。只有这样，它才会作为一个顶级文件夹出现在侧边栏。
- 操作对象要找准：右键时，必须点在侧边栏里那个文件夹图标本身上，点里面的文件或者旁边的空白区域都没用。
- 插件别装错：确认你安装的是作者为
wbond的官方SFTP插件。市场上名字相近的像sftp-client或FTPSync，并不是一回事。 - 最后别忘了重启：安装后务必重启一次Sublime Text。否则插件初始化可能不完整，你甚至在 Project 菜单里都看不到
SFTP相关的选项。
sftp-config.json 放哪、怎么写、为什么总静默失败
这个配置文件是核心，但它不是全局生效的。它被严格绑定在你右键操作的那个文件夹的根目录下。文件名、大小写、扩展名，一个都不能错：必须是 sftp-config.json。写成 SFTP-config.json、sftp_config.json 或者 sftp-settings.json，插件都认不出来。
remote_path（远程路径）：必须以/开头，结尾也建议加上/（例如"/var/www/html/"）。这是为了确保路径拼接时不会发生奇怪的偏移。ssh_key_file（SSH密钥文件）：支持使用~来表示用户主目录（如"~/.ssh/id_rsa"），但它不认识$HOME这类环境变量。- 密钥登录的陷阱：如果使用密钥登录，请务必把
password这个字段从配置里整个删除。哪怕你留一个空字符串（"password": ""），插件也可能依然尝试走密码认证，从而导致连接失败。 - Windows用户注意路径：在Windows系统上指定密钥路径时，要么使用正斜杠
"C:/Users/xxx/.ssh/id_rsa"，要么使用双反斜杠"C:\Users\xxx\.ssh\id_rsa"。
上传失败却没报错？看控制台日志才是真因
遇到弹窗提示“Permission denied”（权限拒绝），或者更糟，什么提示都没有只是上传失败，先别急着怪网络。很多时候，是OpenSSH底层的连接被拦截了。需要知道，这个插件不会复用你系统终端里已经运行的 ssh-agent，也不会继承你可能已经配置好的免密登录状态。
- 打开调试窗口：按下
Ctrl+Shift+P（macOS 是Cmd+Shift+P），调出命令面板，输入SFTP: Show Console并回车。所有SSH/SFTP命令和底层错误信息都会在这里实时打印出来，这是排查问题的第一现场。 - 常见真凶一：
ssh_key_file所指的私钥文件权限不对。在Linux或macOS下，需要执行chmod 600 ~/.ssh/id_rsa来确保权限是600。 - 常见真凶二：远程服务器的
/etc/ssh/sshd_config配置文件中，PubkeyAuthentication（公钥认证）被设置成了no。 - 常见真凶三：
remote_path指定的目录，当前登录用户没有写入权限。例如，你想上传到/var/www/html/，但服务器上这个目录可能属于www-data用户。
upload_on_sa ve 不是实时同步，它不校验、不回滚、不锁文件
这个功能的名字很有迷惑性。“保存时上传”听起来像智能同步，但实际上，它仅仅是在你按下保存快捷键后，触发一次文件上传动作而已。它没有版本比对，没有冲突检测，上传失败后既不会提醒你，也不会把本地的文件恢复成旧版本。在多人协作，或者服务器文件可能被其他方式（如FTP、命令行）修改的场景下，盲目使用很容易覆盖掉别人最新的更改。
sync_down_on_open的作用：这个选项只保证在你打开文件时，从远程拉取一次最新版本。之后你在本地编辑的整个过程中，它不会再检查远程文件是否又被更新过。confirm_overwrite_newer的作用：这个选项可以在检测到本地文件比远程文件旧时，弹窗提醒你。但这需要你手动确认，并非自动处理。- 重要警告：在生产环境部署代码，绝不能依赖
upload_on_sa ve作为唯一手段——它不校验上传结果是否成功，一旦失败，数据就静默丢失了。 - 网络调优：如果服务器响应较慢，可以在配置中添加
"timeout": 10来延长超时时间，默认的3秒对于某些网络环境可能太短了。
其实，最容易被忽略的一点是项目绑定逻辑：upload_on_sa ve 功能只对“属于某个SFTP项目映射的文件”生效。而创建一个项目，不是简单地“打开文件夹”。你必须通过 Project → Sa ve Project As… 生成一个 .sublime-project 文件，或者通过在侧边栏文件夹上右键选择 Map to Remote（映射到远程）来让插件自动生成配置并建立绑定关系。这才是功能生效的前提。
