讲师中心 微信公众号
AI工具推荐 视频效率加速

VSCode如何调试单元测试_VSCode单元测试调试详解

星宇姑娘_1535

星宇姑娘_1535

发布时间:2026-04-08 17:06:33

|

692人浏览过

|

来源于php中文网

原创

点击 Debug Test 没反应,主因是工作目录与 sys.path 不匹配;需配置 "python.testing.cwd" 或 PYTHONPATH,并手动刷新测试面板。

vscode如何调试单元测试_vscode单元测试调试详解

点击 Debug Test 没反应?先看工作目录和模块导入路径

VSCode 的 Debug Test 按钮本质是调用 pytestunittest 命令行,并附加调试器。如果点击后无响应、报 ModuleNotFoundError,或断点直接跳过,90% 是当前工作目录(cwd)与 Python 的 sys.path 不匹配导致的。

  • VSCode 默认以打开的文件夹为工作目录,但你的测试里写的是 from src.mymodule import func,而 src/ 并不在 sys.path
  • 解决方法:在 .vscode/settings.json 中显式指定 "python.testing.cwd",例如:
    "python.testing.cwd": "src"
  • 或者更通用的做法:把 src/ 加进 PYTHONPATH,在 settings.json 里加
    "python.defaultEnvironment": {"PYTHONPATH": "${workspaceFolder}/src"}
    (注意:这是非标准字段,部分版本需配合 python.envFile 使用)
  • 临时验证:在测试文件顶部加 import sys; print(sys.path),运行时看输出是否包含你期望的路径

断点不生效?检查测试框架启动方式和断点位置

断点打在测试函数里却没停住,不是 VSCode 调试器坏了,而是你没让调试器“真正进入”那段代码执行流。

  • pytest 下,断点只能打在 test_* 函数内部、fixture 调用之后;别打在 conftest.py 的 fixture 定义里——除非你加了 --capture=no 且启用 pytest-pdb
  • 异步测试(async def test_*)必须用 pytest-asyncio,否则调试器会直接跳过整个函数
  • 如果你手动写了 if __name__ == "__main__" 并在里面调用 pytest.main(),那 Debug Test 按钮完全不走这条路——它绕过你的入口,直连 pytest runner
  • 确认已启用对应框架:比如用了 pytest,但 settings.json 里还留着 "python.testing.unittestEnabled": true,会导致测试发现失败,自然也没法调试

测试面板空白或不刷新?不是插件问题,是缓存没清

改完测试文件名、挪动了 tests/ 目录、甚至更新了 settings.json,VSCode 测试侧边栏依然显示旧内容或一片空白——这不是 bug,是它根本没重新扫描。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • VSCode 的测试面板**不会自动刷新**。哪怕你保存了新写的 test_math.py,只要没手动触发,它就当不存在
  • 必须点击测试侧边栏右上角那个 刷新按钮(或按 Ctrl+Shift+P → 输入 Python: Discover Tests
  • 如果刷新后仍不显示,检查文件名是否符合默认模式:test_*.py*_test.pymytest.py 就不会被识别
  • 多根工作区下,测试只在当前激活的根目录里扫描,其他文件夹里的测试不会跨区出现

Python + pytest 调试配置的关键参数

图形化向导配出来的设置经常不够用,尤其当项目结构非标准时,得手动调整 settings.json 里的几个核心字段。

  • "python.testing.pytestArgs":控制 pytest 怎么找测试,常用值:
    ["--rootdir=.", "-s", "tests/"]
    其中 -s 允许 print() 输出,调试时必需;--rootdir=. 显式指定根目录,避免路径歧义
  • "python.testing.cwd":决定命令执行时的当前目录,直接影响相对路径导入,如 from config import settings
  • "python.testing.pytestPath":如果你装了多个 Python 环境,或 pytest 在虚拟环境外,这里要填绝对路径,例如:
    "${workspaceFolder}/venv/bin/pytest"
    (Windows 下是 Scripts\pytest.exe
  • 别漏掉 "python.testing.pytestEnabled": true,否则整个测试功能处于关闭状态,按钮灰掉也不奇怪

最常被忽略的一点:改完任何一项配置,包括移动测试文件、重命名、新增 __init__.py,都得点那个 刷新——不是 VSCode 卡,是你没告诉它“该重新看了”。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

1955

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2582

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

896

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2879

2025.09.10

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

2260

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

229

2026.02.03

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2979

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2538

2023.07.27

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

0

2026.09.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn