使用Python subprocess.run捕获gh命令输出异常的问题排查

我在Python中尝试捕获Shell命令gh repo fork --remote的完整stderr输出，该命令在终端执行时的输出为：

$ gh repo fork --remote
! knoepfel/larvecutils already exists
✓ Using existing remote origin

我的Python代码如下：

import subprocess

fork = subprocess.run(["gh", "repo", "fork", "--remote"], capture_output=True, text=True)
print(fork)

但实际打印结果中，换行后的内容被截断，且开头的!未被捕获：

CompletedProcess(args=['gh', 'repo', 'fork', '--remote'], 
                 returncode=0, stdout='', 
                 stderr='knoepfel/larvecutils already exists\n')

我怀疑这和gh命令输出的带颜色的!和✓特殊字符有关，请问这是什么原因？

原因分析与解决方法 #

• gh的输出自适应机制：GitHub CLI（gh）会自动检测输出目标是否为终端（TTY）。在终端运行时，它会输出带颜色、特殊符号（!、✓）的格式化内容；但当输出被程序捕获（比如subprocess）时，它默认会禁用装饰性输出，只保留纯文本核心内容，这就是你看不到!的原因。

• 输出流拆分：终端里的两行输出并非都在stderr。第一行的! ...属于stderr，而第二行的✓ ...实际是输出到stdout的。你的代码只查看了stderr，自然看不到第二行内容，打印fork.stdout就能看到对应的内容。

• 强制完整输出：如果需要捕获和终端完全一致的内容，可以给gh命令加上--color=always参数，强制它输出包含ANSI颜色控制码和特殊符号的内容：

import subprocess

fork = subprocess.run(["gh", "repo", "fork", "--remote", "--color=always"], capture_output=True, text=True)
print("stderr内容:", repr(fork.stderr))
print("stdout内容:", repr(fork.stdout))

这样就能捕获到完整的带格式输出，要是想在终端正常显示颜色，还可以用colorama库处理这些控制码。

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