如何用Python subprocess捕获g++编译GoogleTest的错误并写入日志？

你的理解是否正确？ #

不完全正确。subprocess.check_output的行为是：当执行的命令返回非零退出码（比如编译失败时g++会返回非零值），它会直接抛出subprocess.CalledProcessError异常，程序会终止执行后续的logging.info代码，而不是“直接继续后续流程”。你的脚本因为没有捕获这个异常，所以编译错误既没被捕获，也没写入日志。

如何捕获g++编译错误并写入日志？ #

下面提供两种可靠的实现方式：

方式一：捕获CalledProcessError异常 #

修改代码捕获异常，从异常对象中提取错误输出，同时保留编译成功时的输出记录：

import subprocess
import logging

logging.basicConfig(filename="gtest.log", level=logging.INFO, format='%(asctime)s:%(levelname)s:%(message)s')

try:
    # 将stderr重定向到stdout，统一捕获所有输出
    output = subprocess.check_output(
        "g++ test.cpp -lgtest -lgtest_main -lpthread -I <some header file path>",
        shell=True,
        stderr=subprocess.STDOUT,
        text=True  # 直接返回字符串，无需手动decode
    )
    logging.info(f"编译成功输出:\n{output}")
    # 补充：编译成功后执行测试程序
    test_output = subprocess.check_output("./a.out", shell=True, text=True)
    logging.info(f"测试执行输出:\n{test_output}")
except subprocess.CalledProcessError as e:
    logging.error(f"编译失败，退出码: {e.returncode}\n输出信息:\n{e.output}")

方式二：使用subprocess.run（推荐，更灵活） #

subprocess.run是Python 3.5+官方推荐的API，它不会主动抛出异常，而是返回包含执行结果的CompletedProcess对象，你可以自行判断退出码并处理输出：

import subprocess
import logging

logging.basicConfig(filename="gtest.log", level=logging.INFO, format='%(asctime)s:%(levelname)s:%(message)s')

# 执行编译命令
compile_result = subprocess.run(
    "g++ test.cpp -lgtest -lgtest_main -lpthread -I <some header file path>",
    shell=True,
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=True
)

if compile_result.returncode == 0:
    logging.info(f"编译成功输出:\n{compile_result.stdout}")
    # 执行测试程序
    test_result = subprocess.run("./a.out", shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
    logging.info(f"测试执行输出:\n{test_result.stdout}")
    if test_result.returncode != 0:
        logging.error(f"测试执行失败，退出码: {test_result.returncode}\n错误信息:\n{test_result.stderr}")
else:
    logging.error(f"编译失败，退出码: {compile_result.returncode}\n标准输出:\n{compile_result.stdout}\n错误输出:\n{compile_result.stderr}")

关键注意点 #

• 必须显式处理stderr：默认情况下，check_output和run的stdout参数只捕获标准输出，错误输出会直接打印到控制台，因此需要通过stderr=subprocess.STDOUT合并到标准输出，或者单独捕获stderr。
• text=True参数可以让返回结果直接是字符串，避免手动调用decode("utf-8")。
• 原脚本仅完成了编译步骤，没有执行生成的测试程序，上述代码补充了这部分逻辑，你可以根据实际需求调整。

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