在VSCode中运行调试Pytest需先安装pytest并选择正确解释器,再配置测试框架为pytest、指定测试路径,之后可点击“Run Test”/“Debug Test”运行单个测试,或通过测试面板批量操作。

在 VSCode 中运行和调试 Python 单元测试(Pytest)非常方便,关键是正确配置 Python 解释器、测试框架和工作区设置。
确保 Pytest 已安装并被识别
VSCode 需要能调用 pytest 命令,所以先确认它在当前 Python 环境中可用:
- 打开终端,运行
python -m pytest --version或pytest --version - 如果报错“command not found”,用
pip install pytest安装 - 在 VSCode 中按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac),输入 “Python: Select Interpreter”,选对带 pytest 的环境
配置测试框架为 Pytest
VSCode 默认不自动启用测试功能,需手动指定测试工具:
- 按
Ctrl+Shift+P,输入 “Python: Configure Test Framework” - 选择 pytest
- 指定测试文件路径(如
tests/或**/test_*.py),回车确认 - VSCode 会在工作区根目录生成或更新
.vscode/settings.json,包含类似内容:
"python.testing.pytestArgs": ["tests/"], "python.testing.unittestEnabled": false, "python.testing.pytestEnabled": true
运行和调试单个测试函数
光标放在测试函数内,VSCode 会显示上方出现“Run Test”和“Debug Test”链接:
立即学习“Python免费学习笔记(深入)”;
- 点击 “Run Test” 可快速运行该函数,结果输出在 Python Test Log 终端
- 点击 “Debug Test” 会启动调试会话,支持断点、变量查看、步进等标准调试功能
- 也可右键测试函数名 → “Run Current Unit Test” 或 “Debug Current Unit Test”
查看测试状态与批量操作
左侧活动栏点击 测试图标(?),可看到所有已发现的测试用例树状结构:
- 绿色勾号表示通过,红色叉号表示失败,灰色表示未运行
- 右键测试类或模块,可运行/调试整个组
- 点击顶部的 “Run All Tests” 或 “Debug All Tests” 批量执行
- 失败时点击错误行,会跳转到对应断言位置,方便定位问题
基本上就这些。只要解释器选对、pytest 装好、框架配准,VSCode 就能自动发现、运行和调试测试,体验接近 IDE 原生支持。










