Python调用SSH执行QEMU Guest脚本输出错位问题及修复咨询

1. SSH -t 参数的影响：-t 会强制为SSH会话分配伪终端（PTY），此时远程脚本的输出会包含终端控制字符（如回车符 \r、光标移动指令等）。直接在终端执行时，本地终端会自动解析这些控制字符，显示正常；但通过 subprocess.PIPE 捕获输出时，这些原始控制字符被直接传递给Python的 print 函数，处理不当就会出现行错位——本质是 \r 让光标回到行首后，新内容叠加在旧内容后面，视觉上呈现缩进效果。
2. time.sleep(2) 加剧问题：代码中额外的 sleep 会导致远程输出在缓冲中积累，当 readline() 读取时，多个带控制字符的行被一次性处理，进一步放大了错位现象。

方案1：移除SSH的 -t 参数（优先推荐） #

如果远程脚本不需要交互式终端环境（比如不需要处理密码输入、终端颜色等），直接去掉 -t 参数即可。此时SSH会使用标准管道而非PTY传输输出，不会产生终端控制字符：

import subprocess

my_command = "ssh user_name@ip_address './remote_bash_script.sh'"
my_process = subprocess.Popen(my_command, shell=True, stdout=subprocess.PIPE, universal_newlines=True)

while True:
    my_line = my_process.stdout.readline()
    # 移除不必要的time.sleep(2)
    if not my_line:
        break
    print(my_line.strip())

方案2：保留 -t 时用专业终端交互库处理 #

如果必须保留 -t（比如脚本依赖终端环境变量、需要处理交互式输入），建议使用 pexpect 库替代 subprocess，它专门用于处理带PTY的交互式进程，能自动解析终端控制字符：
首先安装pexpect：

pip install pexpect

然后修改代码：

import pexpect

# 启动带PTY的SSH会话
child = pexpect.spawn("ssh -t user_name@ip_address './remote_bash_script.sh'")
# 实时读取输出
while True:
    try:
        line = child.readline()
        if not line:
            break
        # 解码字节流并处理换行
        print(line.decode().strip())
    except pexpect.EOF:
        break

方案3：强制远程脚本无缓冲输出 #

如果需要保留 -t 且不想引入新库，可以在远程命令前添加 stdbuf -o0，强制脚本的标准输出无缓冲，同时移除本地的 time.sleep(2)：

import subprocess

# 添加stdbuf强制无缓冲输出
my_command = "ssh -t user_name@ip_address 'stdbuf -o0 ./remote_bash_script.sh'"
my_process = subprocess.Popen(my_command, shell=True, stdout=subprocess.PIPE, universal_newlines=True)

while True:
    my_line = my_process.stdout.readline()
    if not my_line:
        break
    # 手动处理可能的回车符
    print(my_line.replace('\r', '').strip())

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