pytest加--pdb可在测试失败时自动进入pdb调试，但仅对未捕获异常（如AssertionError）生效；若异常被try/except吞掉、使用--tb=no、pytest-xdist并行或sys.exit()则失效；推荐通过pyproject.toml固化addopts = ["--pdb"]，并注意fixture变量在pdb中可查但临时路径退出后才清理。

pytest命令行加--pdb就能中断调试，但别漏掉关键细节

测试失败时直接进pdb是最常用做法，执行命令时加上--pdb即可：

pytest --pdb test_example.py

它会在第一个失败点自动触发pdb.set_trace()。但注意：这个开关只对AssertionError和未捕获异常生效，不会在print()或logging输出后停住；如果测试里自己吞掉了异常（比如try/except里没raise），--pdb也进不去。

想让每次运行都默认启用--pdb？改pytest.ini或pyproject.toml

避免每次都敲参数，推荐在项目配置文件里固化设置：

• 用pytest.ini时，在[tool:pytest]节下加addopts = --pdb
• 用pyproject.toml时，写成：

  [tool.pytest.ini_options]<br>addopts = ["--pdb"]

• 注意：如果同时存在多个配置文件，pyproject.toml优先级高于pytest.ini，旧配置可能被忽略
• --pdb和--pdbcls=IPython.terminal.debugger:TerminalPdb可以组合使用，换成IPython调试器体验更好（需先pip install ipython）

--pdb进不去？检查是否被--tb或pytest_plugins干扰

常见静默失效场景：

python-flask-vue-creator

创建 Flask + Vue.js 全栈项目，采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发：创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词：新建项目、创建项目、搭建项目、Flask项目、Vue项目。

下载

• 命令里显式加了--tb=no或--tb=short，会抑制--pdb触发（因为pdb依赖traceback信息）
• 某些插件如pytest-xdist默认禁用--pdb（多进程下pdb不可用），此时必须加-n0关掉并行才能用
• 测试函数里用了os._exit()或sys.exit()，会绕过pytest异常捕获机制，--pdb完全不生效
• 自定义的pytest_exception_interact钩子函数如果返回了True，也会跳过pdb

只想对特定测试启用pdb？用-k或@pytest.mark.pdb精准控制

全局开--pdb太吵，可按需激活：

立即学习“Python免费学习笔记（深入）”；

• 按名称过滤：

  pytest --pdb -k "test_login_failure"

• 用标记（需先注册）：在conftest.py里加

  def pytest_configure(config):<br>    config.addinivalue_line("markers", "pdb: run with pdb on failure")

  然后在测试上写@pytest.mark.pdb，再运行pytest -m pdb
• 更轻量的方式是临时加import pdb; pdb.set_trace()在可疑行，比依赖--pdb更可控

真正容易被忽略的是：pdb进入后，当前帧的局部变量、self、request fixture全都能直接查，但pytest的fixture生命周期管理会让某些对象（比如tmp_path）在pdb退出后才清理——别在pdb里手动删临时文件，可能引发后续测试失败。