如何在VSCode中配置Pytest将测试工作目录设为src并解决发现问题

你的项目结构如下：

C:.
├───src
│   │   config.json
│   │   main.py
└───tests

需要让tests目录下的测试以src为工作目录，直接读取config.json，以下是几种可行的配置方式：

方法1：通过pyproject.toml全局配置Pytest #

在项目根目录创建或修改pyproject.toml，添加Pytest的配置项，直接指定运行测试时的工作目录：

[tool.pytest.ini_options]
testpaths = ["tests"]  # 指定测试文件所在目录
addopts = "--cwd=./src"  # 强制将工作目录切换为src

配置完成后，不管是在VSCode界面运行测试，还是在终端执行pytest命令，都会自动以src目录作为工作目录运行。

方法2：修改VSCode的launch.json（调试测试专用） #

如果习惯用VSCode的调试功能运行测试，可以在.vscode/launch.json中添加以下调试配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Pytest",
            "type": "python",
            "request": "launch",
            "module": "pytest",
            "args": ["tests"],
            "cwd": "${workspaceFolder}/src"  // 固定调试时的工作目录为src
        }
    ]
}

之后选择该调试配置运行测试，就会自动切换到src目录执行。

方法3：用conftest.py动态切换工作目录（跨编辑器通用） #

在tests目录下创建conftest.py，添加自动切换工作目录的全局fixture：

import os
import pytest

@pytest.fixture(autouse=True)
def switch_to_src_dir():
    # 保存原工作目录
    original_cwd = os.getcwd()
    # 计算并切换到src目录
    src_dir = os.path.join(os.path.dirname(__file__), "../src")
    os.chdir(src_dir)
    # 测试执行完成后切回原目录
    yield
    os.chdir(original_cwd)

这个方案不需要依赖编辑器配置，不管是VSCode还是PyCharm都能生效，同时也不影响终端直接运行pytest的场景。

关于之前settings.json配置失效的说明 #

你之前设置的"python.testing.cwd": "./src"可能失效的原因：

• 相对路径可能受VSCode工作空间识别逻辑影响，建议改成绝对路径形式："python.testing.cwd": "${workspaceFolder}/src"
• 若VSCode缓存了旧配置，可尝试重启窗口或清除Python插件缓存后再测试

内容的提问来源于stack exchange，提问作者wordhydrogen