必须禁用unittest并启用pytest,在settings.json中设"python.testing.unittestenabled": false和"python.testing.pytestenabled": true,指定pytestargs路径,重启测试资源管理器;测试文件需置于tests/目录且命名规范;调试时需打开对应test_.py文件并将光标置于test_函数内;多语言测试互不兼容,q#须用mstest框架生成项目。

pytest 配置必须关掉 unittest
VSCode 的 Python 测试发现机制默认会同时扫描 unittest 和 pytest,但两者冲突时会导致测试文件识别失败、test_*.py 被忽略,或测试资源管理器里显示“0 tests found”。
解决方法是显式禁用 unittest,只启用 pytest:
- 在
settings.json中设置:"python.testing.unittestEnabled": false - 同时开启:
"python.testing.pytestEnabled": true - 指定测试路径(可选):
"python.testing.pytestArgs": ["-s", "-v", "tests/"],避免扫描整个项目
改完保存后,务必重启测试资源管理器(点击侧边栏“测试”图标右上角的刷新按钮),否则变更不生效。
test_*.py 文件必须放在正确位置
VSCode 不强制要求目录名,但 pytest 默认只扫描 test、tests、testing 这些目录,以及当前工作区根目录下的 test_*.py 文件。如果测试文件放在 src/test/ 或 app/tests/ 之类非标准路径,pytest 就找不到它。
推荐做法:
- 把测试文件统一放在项目根目录下的
tests/文件夹(不是test/) - 文件名必须以
test_开头或_test.py结尾,例如:test_math.py或math_test.py - 函数名必须以
test_开头,类名以Test开头且不含__init__方法
常见坑:在 src/ 下建了 test_utils.py,但没配 pytestArgs,VSCode 就完全看不见这个文件。
调试单个测试用例要选对上下文
VSCode 测试资源管理器里点击“运行”或“调试”图标,默认行为取决于光标所在位置和当前打开的文件。容易误触发整套测试,或报 No module named 'xxx'。
可靠做法:
- 确保当前打开的是你要调试的
test_*.py文件 - 光标停在某个
test_*函数内部(哪怕只是空行),再点左侧的 ▶️ 或 ? 图标 - 如果想跳过 setup/teardown,直接进断点,需在
launch.json中加配置:"justMyCode": true,并确认 Python 扩展已加载调试适配器
注意:pytest 的 -k 参数(按名称过滤)在 VSCode GUI 里不直出,得靠命令面板执行 Python: Run All Tests 后手动输参数,不如直接终端跑 pytest -k "test_add" -v 来得稳。
Q# 或 Go 等非 Python 语言不能复用 pytest 配置
VSCode 的“测试”侧边栏是语言扩展提供的能力,不是通用功能。Python 扩展贡献了 pytest 和 unittest 支持;Go 扩展只认 *_test.go 和 go test;Q# 完全依赖 .NET SDK 和 dotnet test 命令链 —— 它们彼此隔离,共用一个 UI 但底层无共享逻辑。
所以:
- 不要试图把
go test的参数写进python.testing.pytestArgs,那只会报错 - Q# 项目必须有
Tests.csproj,且dotnet test能成功执行,VSCode 才会在测试视图里列出@Test操作 - 多语言混合项目中,测试资源管理器只显示当前激活编辑器对应语言的测试(比如打开
.py文件就刷 Python 测试,切到.qs就等 Q# 扩展响应)
最常被忽略的一点:Q# 测试必须用 MSTest 框架生成项目,dotnet new mstest -lang "Q#" 这步不能跳,否则 dotnet test 找不到测试入口。











