通过Python subprocess.run执行SSH命令与手动执行输出不一致问题

问题描述 #

在Linux系统通过SSH远程执行Windows系统的命令时，手动在命令行执行和用Python的subprocess.run调用得到的输出存在差异：

所用Python代码 #

result = subprocess.run(ssh_command, shell=True, stdout=subprocess.PIPE)
return_results = str(result.stdout.decode())

输出对比 #

• 手动执行的正确输出：

+++++++
pytest 7.4.4
+++++++

• subprocess执行的异常输出：

[?25l[2J[m[H+++++++
[2;1H]0;C:\windows\system32\conhost.exe[?25hpytest 7.4.4
+++++++

原因分析 #

异常输出中的[?25l、[2J等是ANSI终端转义序列，用于控制光标显示、清屏等终端操作。手动执行时，本地终端会自动解析并执行这些序列，不会显示出来；但subprocess直接捕获了远程输出的原始字节流，包含了这些未被解析的转义序列。另外，conhost.exe相关内容是Windows远程执行时终端环境（控制台宿主进程）的额外输出，手动执行时被终端过滤了。

解决方案 #

1. 远程命令端禁用ANSI输出 #

在SSH命令中设置环境变量或添加命令参数，让Windows端的命令不生成终端控制序列：

• 针对Python/pytest类命令，可设置TERM=dumb（模拟哑终端，避免输出转义序列）：

  ssh user@windows-host "set TERM=dumb && python --version"
  

• 如果是pytest，可直接添加参数禁用终端相关输出：

  ssh user@windows-host "pytest --no-header --no-summary -q"
  

2. Python端过滤转义序列 #

如果无法修改远程命令，可在本地用正则表达式过滤掉ANSI转义序列和多余的conhost行：

import re
from subprocess import run, PIPE

result = run(ssh_command, shell=True, stdout=PIPE, stderr=PIPE)
raw_output = result.stdout.decode()

# 移除所有ANSI转义序列
clean_output = re.sub(r'\x1b\[[0-9;]*[a-zA-Z]|\x1b\][0-9;]*[a-zA-Z]', '', raw_output)
# 过滤包含conhost.exe的行
clean_output = '\n'.join(line for line in clean_output.split('\n') if 'conhost.exe' not in line)

print(clean_output)

3. 优化subprocess调用参数 #

避免shell=True（减少环境差异），同时捕获标准错误输出，确保完整获取执行信息：

from subprocess import check_output, CalledProcessError

try:
    # 将ssh命令拆分为参数列表，避免shell解析的问题
    cmd = ['ssh', 'user@windows-host', 'python --version']
    raw_output = check_output(cmd, stderr=STDOUT).decode()
    # 应用输出清洗逻辑
    clean_output = re.sub(r'\x1b\[[0-9;]*[a-zA-Z]|\x1b\][0-9;]*[a-zA-Z]', '', raw_output)
    print(clean_output)
except CalledProcessError as e:
    print(f"命令执行失败: {e.output.decode()}")

内容的提问来源于stack exchange，提问作者True Vision _ Zunna Berry