FTPSync需添加项目文件夹、重启Sublime Text并配置正确的ftpsync.json才能启用右键菜单;它不支持自动上传,仅响应手动上传命令;密码含特殊字符时应使用password_b64字段及Base64编码,remote_path结尾必须加斜杠。

为什么装完 FTPSync 还没右键菜单
不是插件没装上,是 Sublime Text 没把它“认作项目上下文”。FTPSync 不像普通插件那样装完就全局生效——它只在你明确添加了项目文件夹后,才激活右键项。Project → Add Folder to Project 必须执行,且只能对侧边栏里那个**文件夹图标本身**右键;点空白处、点文件、点未保存的 untitled 标签页,统统无效。装完插件必须重启 Sublime Text,否则 FTPSync 菜单项根本不会注册进右键菜单。
sftp-config.json 和 ftpsync.json 别混用
FTPSync 用的是 ftpsync.json,不是 sftp-config.json。后者是 wbond 的 SFTP 插件专用,放错文件名或路径,FTPSync 就静默失败。这个文件必须放在你通过 Add Folder to Project 加入的项目根目录下,内容至少包含:host、username、password(或 password_b64)、remote_path。如果服务器开了被动模式(PASV),不加 "passive": true 就会卡在连接超时,错误常是 530 Login authentication failed——其实不是密码错,是防火墙拦了数据通道。
“保存即上传”根本不存在,别信宣传语
FTPSync 没有 upload_on_save 或 sync_on_save 这类开关。它只响应手动触发:FTPSync: Upload File(默认快捷键 Ctrl+Alt+U)。所谓“自动同步”是误解:Sublime Text 本身没有文件监听能力,所有上传动作都靠 on_post_save_async 事件驱动,而 FTPSync 并未注册该事件。如果你真需要保存即传,得换回社区维护的 sftp3 插件,并配 "sync_on_save": true ——但注意它走的是 SFTP 协议,不是 FTP。
密码含特殊字符就失败?试试 Base64
FTP 协议对密码里的 @、/、: 等字符极其敏感,明文填 password 字段大概率握手失败。不要 URL 编码,直接用 Base64:
echo -n 'my@pass/word' | base64
结果填进 password_b64 字段,删掉 password 行。另外,remote_path 结尾不加 / 会导致路径拼接错位(比如本地 index.html 传到服务器变成 /public_htmlindex.html),这个斜杠不是可选,是必须。











