pytest-sugar彩色的进度条

核心功能

1. 1. 进度条可视化
   • • 实时显示测试进度（进度条 + 百分比），替代原生单调的 .F.. 符号。
2. 2. 即时失败反馈
   • • 测试失败时立即输出错误信息，无需等待全部用例结束。
3. 3. 彩色标识系统
   • • ✅ 绿色 ✓ = 通过
   • • ❌ 红色 ✗ = 失败
   • • 💛 黄色 ⚠ = 跳过
   • • 🔷 蓝色 ⏱ = 超时（需配合 pytest-timeout）
4. 4. 精简摘要
   • • 默认折叠冗长的 Captured stdout/stderr 输出，点击 <Click to see details> 展开。

安装

pip install pytest-sugar  # 或使用 poetry/pipenv
pytest --version | grep sugar  # 输出中应包含 pytest-sugar

进阶配置（pytest.ini）

[pytest]
# 关闭 sugar 的进度条（保留其他优化）
addopts = --no-sugar

# 强制展开失败用例的输出（禁用折叠）
sugar_show_captured = always

# 自定义超时标识（需安装 pytest-timeout）
sugar_timeout_icon = ⏰

实用技巧

1. 与常用插件协作

• • 并行测试：兼容 pytest-xdist（进度条显示所有 worker 状态）
• • 失败重试：与 pytest-rerunfailures 共存，重试用例显示为 ↻
• • 输出优化：搭配 pytest-sugar + pytest-emoji 增加趣味性

2. 调试模式

临时关闭 sugar 查看原生输出（排查插件冲突）：

pytest -p no:sugar

常见问题解决

进度条不显示/乱码

• 原因：终端不支持 Unicode 或颜色 解决：

export TERM=xterm-256color  # Linux/macOS
set PYTHONIOENCODING=UTF-8   # Windows

与 pytest-xdist 同时使用时进度条异常

• 解决：添加 -n auto 明确指定 worker 数量：

pytest -n auto --tests-per-worker 10

输出被截断（长文本显示不全）

• 解决：在 pytest.ini 中禁用输出折叠：

[pytest]
sugar_show_captured = always

与原生 pytest 输出对比

总结

pytest-sugar 通过 进度条、实时错误、彩色标识 三大核心优化，显著提升本地测试体验。推荐在以下场景使用：

• • 开发调试时快速定位失败用例
• • 团队协作中增强测试报告可读性
• • 大型测试套件需要直观进度反馈

https://github.com/Teemu/pytest-sugar

#PytestSugar #Pytest