在 VSCode 中运行调试 Python 单元测试需安装 Python 扩展和测试框架（如 pytest），配置测试框架、路径及文件匹配规则，测试函数旁点击 ▶ 或虫形图标即可运行或调试，注意命名规范与解释器环境。
在 VSCode 中运行和调试 Python 单元测试其实很直接，关键是配置好测试框架（如 unittest 或 pytest）、正确识别测试文件结构，并利用内置的测试面板和调试器。
确保 Python 扩展和测试框架已安装
VSCode 本身不自带 Python 测试功能，依赖官方 Python 扩展（由 Microsoft 提供）以及你项目中实际使用的测试工具。
- 在扩展市场搜索并安装 “Python”（ID: ms-python.python）
- 确认你的工作区已激活合适的 Python 环境（左下角查看解释器路径）
- 如果用
pytest，终端中运行pip install pytest；若用标准库unittest，无需额外安装
配置测试框架和发现规则
VSCode 需要知道用哪个框架、从哪找测试。打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入并选择：
Python: Configure Test Framework
- 选择框架（
unittest或pytest） - 指定测试文件夹（如
tests/或.） - 设置测试文件匹配模式（默认
test_*.py或*_test.py，pytest还支持test_*.py和*_test.py）
配置会写入工作区的 .vscode/settings.json，例如：
立即学习“Python免费学习笔记（深入）”；
"python.testing.pytestArgs": ["tests"],<br>"python.testing.unittestEnabled": false,<br>"python.testing.pytestEnabled": true
运行和调试单个测试
测试发现成功后，VSCode 会在测试函数上方显示绿色 ▶ 按钮（“Run Test”）和虫形图标（“Debug Test”）。
- 点击 ▶ 直接运行该测试，结果出现在 Test 面板（可通过 Ctrl+Shift+P → Python: Show Test Explorer 打开）
- 点击虫形图标即可调试：自动附加调试器，断点生效，可查看变量、调用栈、执行步进
- 也可右键测试方法名 → “Run Test” 或 “Debug Test”
常见问题快速排查
如果测试没出现或报错，优先检查这几项：
-
测试文件名不符合命名规则：比如写成
mytest.py而非test_mytest.py -
测试类/方法未按规范定义：
unittest要求类继承unittest.TestCase，方法以test_开头；pytest要求函数名以test_开头或类名以Test开头且无__init__ -
当前 Python 解释器找不到测试模块：检查
sys.path，必要时在settings.json中添加"python.defaultInterpreterPath"或使用PYTHONPATH - 测试面板空白：尝试执行命令 Python: Discover Tests 手动触发扫描
基本上就这些。配置一次，后续测试运行和调试就跟写代码一样顺手。
