subprocess执行gh命令输出与shell不一致的原因及解决方法

gh客户端的颜色输出逻辑基于**标准输出是否为交互式终端（TTY）**判断：

• 在终端执行gh api organizations | cat时，gh的标准输出被重定向到管道（非TTY环境），因此gh自动禁用ANSI颜色，输出纯JSON。
• 使用subprocess.run(..., shell=True, capture_output=True)时输出不同，通常是两个原因：
  • gh误判输出环境为TTY：部分场景下，shell环境或subprocess的默认配置会让gh认为自己处于终端环境，继续输出带颜色的内容；
  • 捕获了额外输出：比如gh的stderr信息（警告、错误）被一并捕获，导致最终输出和终端管道的纯JSON不一致。

以下几种方式可以强制gh输出纯JSON，不受环境影响：

1. 使用--no-color参数（最直接） #

直接在gh命令中添加该参数，强制禁用颜色输出：

import subprocess

result = subprocess.run(
    'gh api organizations --no-color',
    shell=True,
    capture_output=True,
    text=True
)
print(result.stdout)

2. 设置NO_COLOR环境变量 #

gh遵循NO_COLOR标准环境变量，设置后会自动禁用颜色：

import subprocess
import os

env = os.environ.copy()
env['NO_COLOR'] = '1'
result = subprocess.run(
    ['gh', 'api', 'organizations'],
    capture_output=True,
    text=True,
    env=env
)
print(result.stdout)

3. 直接调用gh命令（不通过shell，推荐） #

避免使用shell=True，直接以列表形式传递命令参数，此时gh的stdout直接连接到subprocess的管道，会自动识别为非TTY环境，输出纯JSON：

import subprocess

result = subprocess.run(
    ['gh', 'api', 'organizations'],
    capture_output=True,
    text=True
)
print(result.stdout)

这种方式不需要额外管道到cat，因为subprocess的capture_output=True本身就是捕获stdout，gh会自动适配输出格式。

4. 强制指定JSON输出格式 #

通过--json参数明确指定输出字段（用"*"表示所有字段），确保输出为纯JSON：

import subprocess

result = subprocess.run(
    ['gh', 'api', 'organizations', '--json', '*'],
    capture_output=True,
    text=True
)
print(result.stdout)

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