为什么pytest-sugar在GitLab CI环境中无法正常显示格式化输出

问题原因 #

• pytest-sugar的美化输出（进度条、彩色标识、自定义排版）依赖TTY交互式终端和ANSI颜色转义支持。GitLab CI Runner默认使用非交互式输出流，不会分配TTY终端，默认关闭彩色输出能力，pytest和pytest-sugar检测到运行环境不支持对应特性时，会自动降级为普通文本输出。
• 当前CI配置中的pytest命令未强制开启颜色输出，pytest默认在非TTY环境下会自动禁用彩色输出，导致pytest-sugar无法加载对应样式。
• 小概率排查项：确认你的requirements.txt中已经明确声明了pytest-sugar依赖，避免本地环境提前安装了依赖但CI容器中未安装，直接使用pytest默认输出格式。

解决方法 #

修改CI配置中的pytest执行命令，添加强制开启颜色和pytest-sugar的参数即可：

api:
  stage: tests
  script:
    - pytest $TESTS_ENVIRORMENT Tests/API/ -v --color=yes --force-sugar

参数说明：

• --color=yes：强制pytest开启ANSI彩色输出，不受当前终端类型限制
• --force-sugar：pytest-sugar自带的专用参数，强制启用sugar的美化输出格式，跳过终端环境检测逻辑

如果你使用Docker Executor类型的GitLab Runner，也可以在Runner的config.toml对应项目配置段开启tty = true，但修改执行命令的方案通用性更强，不需要调整Runner侧配置。

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