在VS Code中直接调试单个pytest测试函数，需先配置Python测试框架为pytest并完成测试发现，然后右键测试函数选择“Debug Test”即可自动启动带断点的调试会话；手动配置launch.json时须设"module": "pytest"、args指定具体测试路径如["tests/test.py::test_func"]，并确保cwd和PYTHONPATH正确。
怎么在 VS Code 里直接调试单个 pytest 测试函数
VS Code 默认不识别 pytest 的测试结构，必须显式告诉它“这是一个 pytest 用例，用 pytest 运行器启动”。关键不是改 python 调试配置，而是用 python-testing 类型的配置，并指定 pytest 为测试工具。
实操建议：
- 确保已安装
pytest（pip install pytest）且 VS Code 已启用 Python 扩展和 Python Test Explorer 扩展（推荐） - 在项目根目录下打开命令面板（
Ctrl+Shift+P），运行Python: Configure Tests→ 选pytest→ 指定测试目录（如tests/或.）→ 完成后 VS Code 会自动生成settings.json中的python.testing.pytestArgs - 此时右键某个
def test_*函数 →Debug Test，VS Code 会自动创建临时调试配置并启动带断点的 pytest 进程
手动写 launch.json 调试 pytest 单文件或单函数时要注意什么
手动配置 launch.json 是为了更细粒度控制（比如传参、环境变量、coverage），但容易错配 request 类型或入口路径。
常见错误现象：断点不命中、报 ModuleNotFoundError、提示 No module named pytest。
立即学习“Python免费学习笔记（深入）”；
实操建议：
-
type必须是python（不是python-testing），request必须是launch -
module字段设为pytest，而不是写脚本路径；用args传测试目标，例如：["tests/test_math.py::test_add"]或["-s", "tests/"] -
cwd（工作目录）要设为项目根目录，否则 pytest 找不到被测模块；如果被测代码在src/下，还需加"env": {"PYTHONPATH": "${workspaceFolder}/src"} - 避免用
program指向pytest可执行文件——跨平台路径不可靠，module更稳定
为什么 pytest 参数加在 args 里却没生效
launch.json 中的 args 是透传给 pytest 命令行的，但顺序和语义必须符合 pytest 规则，否则会被忽略或报错。
使用场景：想调试时显示 print 输出、跳过某些 fixture、启用详细日志。
实操建议：
-
-s（允许输出）和-v（详细模式）必须放在args最前面，否则 pytest 可能解析失败 - 测试路径或函数名必须是最后一个参数，例如：
["-s", "-v", "--tb=short", "tests/test_api.py::test_login"] - 不要在
args里写--debug（那是 VS Code 自己的调试开关，不是 pytest 的）；pytest 的调试相关参数是--pdb或--trace，但它们和 VS Code 断点冲突，慎用 - 如果用了
pytest-xdist（如-n 2），调试会失效——多进程下 VS Code 无法 attach 子进程，调试时务必去掉并发参数
调试时 import 报错 ModuleNotFoundError 怎么快速定位
这不是 pytest 问题，是 VS Code 启动调试器时 Python 解释器找不到模块路径。根本原因通常是 sys.path 没包含你的源码目录。
性能 / 兼容性影响：硬改 sys.path 在代码里只是临时解法，不利于 CI 和他人复现；用 PYTHONPATH 或 setup.py develop 更规范。
实操建议：
- 先确认你当前选择的 Python 解释器是否正确（左下角状态栏点击 Python 版本，选对虚拟环境）
- 在
launch.json的env中显式添加PYTHONPATH，例如："PYTHONPATH": "${workspaceFolder}/src:${workspaceFolder}" - 如果项目有
pyproject.toml且用的是 PEP 517 构建，可以加"env": {"PYTHONPATH": "${workspaceFolder}"} + pip install -e .（推荐长期方案） - 别依赖
__file__动态推导路径——调试器启动方式不同会导致__file__指向 pytest 内部文件，不可靠
最易被忽略的是：VS Code 的调试配置不会自动继承终端里的环境变量（比如你在 shell 里 export PYTHONPATH 了，但调试器看不到）。所有路径依赖都得显式写进 launch.json 的 env 里。
