使用Python subprocess.Popen执行scp无法获取传输进度输出的问题

问题核心原因 #

scp的传输进度信息默认输出到标准错误流(stderr)，而非标准输出(stdout)；同时communicate()会阻塞到命令执行完毕才返回结果，无法实时获取进度；另外scp在非交互式终端环境下可能默认抑制进度输出。

解决方案 #

1. 捕获stderr并实时读取输出

修改代码，同时捕获stderr流，循环读取实时输出，而非等待命令结束：

from subprocess import Popen, PIPE

# 推荐用列表形式传递命令参数，避免shell注入风险，无需设置shell=True
scp_command = [
    'scp',
    '-i', 'c:<local_key>',
    '<filepath to local file>',
    '<user>@<destination_device>:/path'
]

# 开启行缓冲，实现实时输出
process = Popen(
    scp_command,
    text=True,
    stdout=PIPE,
    stderr=PIPE,
    bufsize=1  # 行缓冲模式
)

# 实时读取stderr中的进度输出
for line in process.stderr:
    print(line.strip())

# 等待命令完成，获取返回码
return_code = process.wait()
print(f"scp执行状态码: {return_code}")

2. 强制scp输出进度（若上述方法仍无输出）

部分scp版本在非TTY环境下会默认关闭进度输出，此时添加-v参数开启verbose模式，强制输出进度及详细日志：

scp_command = [
    'scp',
    '-v',  # 开启verbose模式，强制输出进度信息
    '-i', 'c:<local_key>',
    '<filepath to local file>',
    '<user>@<destination_device>:/path'
]

关键注意点 #

• 不要用communicate()获取进度：它会阻塞到命令结束，只能拿到最终输出，无法实时追踪进度
• 优先用列表传递命令参数：比字符串更安全，避免路径或用户名含特殊字符时出现解析错误
• 修正目标路径格式：原命令中的:\path需改为:/path（适配Linux目标设备的路径规范）

内容的提问来源于stack exchange，提问作者rogueakula