安装后未生效是因为pytest-sugar需显式启用，最简方式是运行pytest --sugar；也可在pyproject.toml中配置addopts = ["--sugar"]；与pytest-xdist并用时需禁用多进程（-n 0）以避免渲染冲突。
安装 pytest-sugar 后为什么终端还是老样子？
因为 pytest-sugar 不是默认启用的插件，它需要显式启用或配置——即使已用 pip install pytest-sugar 安装成功，运行 pytest 时也不会自动生效。
- 最简方式：加
--sugar参数启动，例如pytest --sugar - 更常用的是写进配置文件，避免每次敲参数；推荐在项目根目录放
pyproject.toml，内容如下：
[tool.pytest.ini_options] addopts = ["--sugar"]
注意：如果已有 pytest.ini 或 setup.cfg，也要确保其中的 addopts 包含 --sugar，否则会被覆盖。
和 pytest-xdist 并用时进度条错乱或卡住
pytest-sugar 的实时进度渲染与 pytest-xdist 的多进程输出存在冲突——多个 worker 同时写终端会导致光标跳动、字符重叠甚至假死。
- 开发调试阶段建议先禁用 xdist：
pytest --sugar -n 0（-n 0强制单进程） - CI 或批量运行时，可保留 xdist 但关闭 sugar：
pytest -n auto，不带--sugar - 若坚持要两者共存，可尝试
--tb=short+--quiet缓解干扰，但进度条仍可能不准
自定义测试结果符号（✓/✗）不生效
pytest-sugar 默认使用 Unicode 符号，部分终端（如 Windows CMD、某些 SSH 客户端）不支持或未启用 UTF-8，会显示为方块或问号。
- 检查当前终端编码：
python -c "import sys; print(sys.stdout.encoding)"，非utf-8时需先修复终端环境 - 临时降级为 ASCII：在
pyproject.toml中加sugar_unicode = false - 对应配置项是
[tool.pytest.ini_options]下的sugar_unicode = false，不是addopts
测试失败时堆栈太长，关键信息被刷屏
pytest-sugar 默认开启详细 traceback，但对快速定位问题反而不利——尤其当用 assert 比较大结构体时，整个 diff 占满屏幕。
- 用
--tb=short或--tb=line压缩 traceback，和--sugar兼容良好 - 若想只在失败时展开完整堆栈，可搭配
pytest-instafail插件：pip install pytest-instafail，再加参数--instafail - 注意：sugar 的「实时失败高亮」依赖 pytest 原生的 report hook，第三方插件若劫持了
pytest_runtest_makereport可能导致颜色丢失
真正麻烦的不是装不上，而是它和别的插件抢 stdout、抢 hook、抢编码控制权——调一个参数前，先看它背后绑着几个隐性依赖。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
