如何在Jenkins中实时查看pytest执行的带颜色控制台输出

核心问题说明 #

• pytest默认会检测输出终端是否为交互式TTY，Jenkins执行任务时属于非TTY输出场景，默认会自动关闭ANSI颜色输出，所以-s模式下看不到颜色
• --capture tee-sys模式会对输出做缓冲处理，只有缓冲满或任务结束才会统一输出，所以无法实时刷新

配置步骤 #

1. 调整pytest执行命令 #

直接使用如下组合参数即可同时满足实时输出+保留颜色的需求：

pytest -s [path_to_test] --color=yes

参数说明：

• -s：关闭pytest对标准输出/标准错误的捕获，输出内容直接打印到控制台，实现实时刷新
• --color=yes：强制pytest始终输出带ANSI色码的内容，不受非TTY终端场景影响

2. 配置Jenkins控制台支持颜色解析 #

需提前完成Jenkins侧的配置，否则颜色码会直接以原始字符形式显示：

• 安装Jenkins官方插件「AnsiColor」
• 自由风格任务：在任务配置页的「构建环境」分类下，勾选 Color ANSI Console Output 选项
• Pipeline任务：在执行pytest的步骤外层包裹ansiColor块，示例：

ansiColor('xterm') {
    sh 'pytest -s your_test_dir --color=yes'
}

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