怎么在VSCode中配置Python的单元测试？_Pytest与Unittest框架【教程】_网络技术

VSCode需正确配置Python解释器、启用对应测试框架（pytest/unittest）并遵循文件命名规则，才能在侧边栏集成测试发现与运行；关键在于解释器路径、settings.json声明及测试结构匹配。

VSCode 本身不自带 Python 单元测试运行能力，但能通过配置 settings.json 和正确安装依赖，让测试发现、运行、调试完全集成到侧边栏和命令面板中——关键不是装插件，而是让 VSCode 知道“测试在哪、用什么跑、怎么找”。

VSCode 的 Python 测试功能由官方 ms-python.python 扩展提供，不是第三方插件。如果测试图标（⚡ 图标）不出现，大概率是解释器没选对或扩展未激活。

按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Python: Select Interpreter，选中你项目实际使用的 Python 环境（如 ./venv/bin/python 或 conda env 路径）
确保该环境下已安装 pytest 或 unittest：在终端执行 pip list | grep -i pytest 或 python -m unittest --help 验证
若使用 conda，注意 VSCode 可能默认选系统 Python，而非 conda env 中的解释器——必须手动指定

VSCode 不会自动猜你用的是 pytest 还是 unittest，必须显式声明。配置写在工作区或用户级 settings.json 中，优先级：工作区 > 用户。

用 unittest：

"python.testing.unittestEnabled": true,
"python.testing.unittestArgs": [
    "-s",
    "./tests",
    "-p",
    "test_*.py"
],

-s 指定起始目录，-p 指定匹配模式（注意：不支持 **/test_*.py 这种 glob，只认单层通配）

禁用另一个框架：比如启用了 pytest，务必设 "python.testing.unittestEnabled": false，否则可能冲突报错 Test discovery failed: multiple test frameworks enabled

VSCode 的测试发现完全依赖底层框架规则。即使配置全对，文件放错位置或命名不对，测试列表就是空的。

pytest 默认只找：test_*.py 或 *_test.py 文件，且文件内函数或类名需以 test_ 开头；测试目录下建议有 __init__.py（非必须但避免导入问题）
unittest 要求更严格：测试类必须继承 unittest.TestCase，方法名必须是 test_*，且文件名必须匹配 unittestAr gs 中的 -p 模式（例如设了 "test_*.py"，就不能叫 example_tests.py）
常见坑：tests/ 目录不在 Python path 中 → 导入被测模块失败；解决办法是在测试文件开头加：
```
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).parent.parent))
```
或在根目录放 pyproject.toml 声明 [tool.setuptools.py_modules]

点击测试旁的 ▶️ 或 ? 图标时，VSCode 会调用当前选中的 Python 解释器执行命令。如果你在虚拟环境中安装了 pytest，但解释器指向全局 Python，就会报 ModuleNotFoundError: No module named 'pytest'。

检查底部状态栏：左边应显示类似 Python 3.11.5 ('venv': venv)，括号里有环境标识才算生效
调试单个测试函数时，VSCode 会生成临时 launch config，但断点只在测试代码里有效——被测模块若在其他包中，需确保其源码可访问（不能只装 wheel）
想看 print() 输出？在 pytestArgs 加 -s（捕获关闭），或加 --log-cli-level=INFO 查看日志

最常卡住的地方不是配置语法，而是解释器路径和测试文件结构不匹配。每次改完 settings.json，记得重启 VSCode 窗口（不是重载窗口），再点「Python Test Explorer」侧边栏刷新按钮——它不会自动轮询配置变更。