Windows下Python脚本如何捕获git fsck命令的输出

• git fsck的进度类输出（包括终端中看到的Checking object directories: 100% (256/256), done.这类提示）默认做了终端检测：仅当标准错误流连接到交互式终端（TTY）时才会输出，当输出被重定向到文件、管道时，Git会默认关闭这类进度输出。这是和git status的核心区别——git status的结果输出不做终端检测，无论是否重定向都会正常返回内容。
• Windows环境下Python的subprocess调用未做流合并、编码配置时，也可能出现输出丢失的情况。

原生subprocess实现 #

给git fsck添加--progress参数，强制Git忽略终端检测、始终输出进度信息，同时修正流重定向逻辑，参考代码：

import os
import subprocess

os.chdir(repo_path)
# Windows下写入文件建议显式指定utf-8编码，避免出现乱码
with open("blah.txt", "w", encoding="utf-8") as f:
    subprocess.run(
        ["git", "fsck", "--progress"],
        stdout=f,
        stderr=subprocess.STDOUT, # 将stderr的进度输出合并到stdout流，统一写入文件
        check=True
    )

运行后即可在blah.txt中看到和终端执行一致的完整输出。

GitPython实现 #

GitPython底层是对Git原生命令的封装，同样需要传入--progress参数强制输出进度，参考代码：

from git import Repo

repo = Repo(repo_path)
with open("blah.txt", "w", encoding="utf-8") as f:
    proc = repo.git.fsck("--progress", as_process=True)
    for line in proc.stdout:
        f.write(line.decode("utf-8", errors="ignore"))
    proc.wait()

补充说明：如果仅需要捕获git fsck输出的悬空提交、悬空文件对象等检查结果，不需要添加--progress参数也能正常获取；只有进度类的实时提示信息需要通过该参数强制开启输出。

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