开启 sftp-config.json 的 "log_level": 2 和 "log_path" 可输出完整传输日志,定位卡顿环节;手动执行日志中的 pscp 命令可验证底层链路;禁用 upload_on_save 后用 Ctrl+Alt+u+F 手动上传才能测试续传;并发上传需调优 concurrent_connections 和 transfer_buffer_size。

用 sftp-config.json 开启日志并观察真实传输行为
Sublime SFTP 插件默认不输出传输细节,所谓“卡住”“超时”“连不上”,八成是黑盒状态下的猜测。必须打开 debug 日志,才能看到它到底在 LIST 还是在 PUT、卡在哪一步、用了哪个底层命令。
在 sftp-config.json 中加入这两项:
-
"log_level": 2(值为 2 表示输出完整传输日志,1 是警告,0 是关闭) -
"log_path": "/tmp/sftp-debug.log"(Linux/macOS)或"log_path": "C:/temp/sftp-debug.log"(Windows,确保目录存在且可写)
保存后重启 Sublime Text,再操作一次上传/下载。打开日志文件,你会看到类似这样的行:
PUT /home/user/project/src/main.py -> /var/www/app/src/main.py (12.4 MB) pscp -batch -i "C:/keys/deploy.ppk" -P 22 -scp -v -timeout=300 ...
关键看最后是否出现 Exit code: 0;若中途断在 Waiting for response... 或报 Connection timed out,就不是网络慢,而是插件参数没配对。
手动触发 pscp 命令验证底层链路是否可靠
Sublime SFTP 在 Windows 上默认调用 pscp.exe,Linux/macOS 则调用系统 sftp 或 scp。如果插件连不上,但终端能通,说明问题出在插件配置而非服务器本身。
直接复用日志里打出的完整 pscp 命令(去掉 -batch 和引号逃逸,补上密码或密钥路径),在 CMD 或 PowerShell 里手动跑一次:
pscp -i "C:keysdeploy.ppk" -P 22 -v -timeout=300 src/main.py user@host:/var/www/app/src/
观察输出:
- 若卡在
Connecting to host...→ 检查host是否可解析、端口是否被防火墙拦截 - 若卡在
Waiting for server banner...→ 服务器 SSH 服务未响应,或/etc/ssh/sshd_config中UseDNS yes导致反向 DNS 查询超时 - 若成功传输但插件失败 → 插件读取了错误的私钥路径、或
remote_path少了结尾/导致路径拼接异常
用大文件 + 断网模拟测试续传与中断恢复能力
“稳定性”不是指“一次成功”,而是“断了还能续、错了能重来”。SFTP 插件本身不支持断点续传,但它依赖的 pscp 和 scp 支持 -resume(pscp)或靠重传机制隐式恢复(OpenSSH scp),前提是远程残留 .part 文件没被自动清理。
实操步骤:
- 准备一个 500 MB 的测试文件(如
test.bin) - 在上传中途(比如进度到 30%)拔掉网线或禁用 Wi-Fi
- 等插件报错后,检查远程目标目录是否存在
test.bin.part - 恢复网络,删掉本地已修改但未上传完的
test.bin(避免时间戳冲突),然后手动运行带-resume的 pscp 命令 - 对比远程文件 MD5,确认是否真正续传而非重传
注意:upload_on_save: true 模式下无法续传——它会直接覆盖远程文件,.part 文件会被清空。真要测续传,必须关掉自动上传,改用快捷键 Ctrl+Alt+u+F 手动触发。
监控 concurrent_connections 和 transfer_buffer_size 对多文件同步的影响
当你右键“Upload Folder”时,插件默认并发 1 个连接,每文件单独建通道。如果目录里有 200 个小文件(如编译产物、日志切片),它会串行发起 200 次 pscp 调用,中间任意一次超时都会中断整个流程,且无重试逻辑。
可在配置中显式控制:
-
"concurrent_connections": 3(最多同时开 3 个传输通道,别设太高,容易触发服务器MaxStartups限制) -
"transfer_buffer_size": 65536(默认 32768,增大可提升单次吞吐,但超过 131072 可能导致 Windows 下 pscp 崩溃) - 配合
"ignore_regexes": [".*\.log$", ".*\.tmp$"]排除干扰项,避免无效 LIST 拖慢整体响应
最容易被忽略的是:这些参数只在“整个文件夹上传”时生效,单文件 Ctrl+S 保存仍走默认单通道。真要压测稳定性,得用文件夹上传 + 大量小文件组合,而不是只盯着一个 .py 文件反复保存。











