pytest失败时最快定位断点是在用例中加breakpoint()；Python 3.11默认启用增强pdb，支持语法高亮与补全；-v --pdb可自动在失败/错误时进入调试器，--pdb-trace可在异常抛出前中断。
pytest执行失败时如何快速定位断点
直接在失败用例里加 breakpoint() 是最轻量的方式。Python 3.11 默认启用 pdb 的增强模式（带语法高亮、自动补全），无需额外配置。但要注意：如果测试用例是通过 pytest -x 或 --tb=short 等参数运行的，断点仍会触发，只是 traceback 被截断——这不影响调试本身，但可能让你误以为“没进断点”。
常见错误现象：加了 breakpoint() 却没停住。原因通常是：
- 测试被 pytest 缓存跳过（比如用了
--lf但缓存中记录为“已通过”） - 用例实际没被执行（比如
@pytest.mark.skip或条件不满足） - 在 fixture 中设断点，但 fixture 没被该用例调用
怎样让pytest在失败时自动进入pdb
不用手动插断点，用 -v --pdb 即可。失败后自动进入交互式调试器，此时能直接检查局部变量、执行表达式、用 pp vars 美化打印对象。
关键细节：
立即学习“Python免费学习笔记（深入）”；
-
--pdb只对失败（F）和错误（E）生效，跳过（s）或预期失败（xfail）不会触发 - 想在断言失败前就暂停？用
--pdb-trace（Python 3.11+ 支持），它会在异常抛出前一层帧中断 - 如果终端不支持 readline（比如某些 CI 环境），
--pdb可能卡住，此时改用--pdb --capture=no避免输出被重定向干扰
为什么pytest -s 和 --capture=no 都不能让print生效
不是 print 失效，而是 pytest 默认捕获 stdout/stderr 并只在失败时才输出。但即使加了 -s，若用例本身被异常中断（比如 KeyError），print 可能只输出一半就被截断。
更可靠的日志方式：
- 用
logging.debug("msg")+--log-level=DEBUG，日志会完整保留 - 用
print()时显式刷缓冲：print("debug", flush=True) - 避免在
__del__或异常处理末尾 print —— Python 3.11 的异常链机制可能导致这些代码根本不执行
fixture内部出错怎么调试
fixture 错误常表现为 “setup failed”，但 traceback 可能只显示顶层调用，看不出具体哪行出问题。此时要：
- 在 fixture 函数内加
breakpoint()，或用@pytest.fixture(autouse=True)临时标记可疑 fixture - 用
pytest --fixtures test_file.py查看 fixture 依赖树，确认执行顺序 - 注意 scope 影响：function 级 fixture 失败会导致所有依赖它的用例标为
E；session 级 fixture 失败则整个 session 终止 - 如果 fixture 含异步逻辑（如
async def），pytest 3.11 默认不支持，必须用pytest-asyncio插件，否则会静默失败
最易被忽略的是：Python 3.11 的 ExceptionGroup 会让多线程/async 测试的 traceback 显示为嵌套结构，--tb=short 会折叠关键信息，务必用 --tb=auto 或 --tb=long 查看完整异常链。
