restic命令动态更新行未输出至stdout/stderr的问题排查

问题1：为何'repository ae412afe opened (version 1)'行不在输出文件中？ #

这条信息是restic输出到**stderr（标准错误流）**的，而非stdout（标准输出流）。如果你的重定向命令只处理了stdout（比如restic restore ... > output.log），stderr的内容会直接输出到终端，不会写入文件。要同时捕获stdout和stderr，需要用restic restore ... > output.log 2>&1这样的命令，把stderr重定向到stdout，或者单独把stderr写入另一个文件（2> error.log）。

问题2：动态更新的进度行去向何处，如何在Python脚本中显示该内容？ #

进度行的去向 #

restic的动态进度行是直接写入终端TTY设备的，而非标准流（stdout/stderr）。当restic检测到输出不是交互式终端（比如被重定向到文件或被subprocess捕获）时，会自动禁用动态进度输出，或者直接跳过向标准流输出进度内容。

Python脚本中捕获显示的方法 #

要让restic输出动态进度并捕获，需要模拟交互式终端环境，同时正确读取输出：

1. 使用pty模块创建伪终端，让restic认为自己在交互式终端中；
2. 读取伪终端的输出并实时打印。

示例代码：

import subprocess
import os
import pty

# 构造restic restore命令
restic_cmd = ["restic", "restore", "dff2f51a", "--target", "/Users/matt"]
# 复制系统环境变量，添加TERM参数模拟终端
env = os.environ.copy()
env["TERM"] = "xterm"

# 创建伪终端
master_fd, slave_fd = pty.openpty()
# 启动子进程，绑定伪终端的slave端作为输入输出
proc = subprocess.Popen(
    restic_cmd,
    stdin=slave_fd,
    stdout=slave_fd,
    stderr=slave_fd,
    env=env
)
os.close(slave_fd)

# 实时读取并打印输出
try:
    while True:
        output = os.read(master_fd, 1024).decode()
        if not output:
            break
        print(output, end='')
except OSError:
    pass

proc.wait()
os.close(master_fd)

另外，也可以通过给restic添加--verbose参数，让更多日志（包括进度相关的静态信息）输出到stderr，或者用--no-progress关闭动态进度，换成静态的进度输出到stdout，这种方式不需要模拟终端，直接通过subprocess捕获stderr/stdout即可。

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