FTPSync需先添加文件夹到项目才能显示右键菜单，配置ftpSync.settings时注意host不加ftp://、passive需显式设为true、remote_path以/开头，错误信息在Ctrl+`控制台查看。
FTPSync 插件不能自动上传，保存文件不会触发同步——它只支持手动上传/下载，且配置稍有偏差就连接失败。
怎么装 FTPSync 并让它出现在右键菜单
Sublime Text 4 默认禁用未签名插件，而 FTPSync 是少数仍兼容的轻量 FTP 工具，但安装后常“看不见”右键选项，根本原因是没正确加载项目上下文。
- 必须先通过
Project → Add Folder to Project添加一个本地文件夹（空文件夹也行），不能只打开单个文件 - 重启 Sublime Text —— 这步不可跳过，否则右键菜单不显示
FTPSync项 - 在侧边栏中右键点击该文件夹（不是空白处或文件），才能看到
FTPSync → Setup FTPSync in this folder - 成功后会生成
ftpsync.settings（注意不是.json），路径在项目根目录下
配置 ftpsync.settings 的关键字段和坑点
这个文件没有 Schema 校验，写错字段名或值类型也不会报错，而是静默失败。最常见错误是登录失败却提示 530 Login authentication failed，实际跟密码无关。
-
"host"填域名或 IP，不要带ftp://前缀；"port"默认21，如果服务器用的是 FTPS（隐式 SSL），端口通常是990 -
"username"和"password"明文写风险高；若密码含@、/等特殊字符，需 URL 编码，或改用"password_b64"字段填 Base64 编码后的字符串 - 服务器启用了被动模式（PASV）？必须显式加
"passive": true，否则卡在连接阶段，超时无提示 -
"remote_path"必须以/开头，且是服务器上真实存在的可写路径，比如/public_html/；末尾斜杠影响行为（有斜杠=传入目录内，无斜杠=重命名上传）
上传失败时怎么看具体错误
FTPSync 不像 SFTP 插件那样提供图形化输出面板，错误信息全藏在 Sublime 控制台里，不主动调出就以为“没反应”。
- 按
Ctrl+`（反引号）打开 Sublime 控制台，上传失败时通常能看到类似ftpsync: error: 530或Connection timed out的原始响应 - 手动触发上传：右键文件 →
FTPSync → Upload Current File，或用快捷键（需自行配置）ctrl+alt+u - 想下载远程文件覆盖本地？右键文件夹 →
FTPSync → Download，但注意它不会递归拉取子目录，只同步当前层 -
"exclusions"只支持精确匹配路径前缀，不支持通配符，比如想跳过.git，得写"exclusions": [".git/", ".gitignore"]
它不监听文件变化，也不校验上传结果是否成功，所谓“同步”只是单向搬运。如果你需要保存即上传、多环境切换或 SSH 密钥登录，FTPSync 就不是合适选择——它只适合老式虚拟主机、仅开放 FTP 端口、且你愿意每次按一次快捷键的场景。
