Docker化Django项目VSCode中Pytest调试发现错误求助

一、先确保VSCode在容器环境内操作 #

• 用VSCode的Remote - Containers扩展直接进入Docker容器的开发环境，本地环境和容器环境完全隔离，必须在容器上下文里调试。
• 进入后，按Ctrl+Shift+P选「Python: Select Interpreter」，一定要选容器内的Python解释器，别选本地的虚拟环境。

二、修正pytest与路径配置 #

1. 调整.vscode/settings.json #

把以下配置加到settings里，明确pytest的参数和项目路径：

{
    "python.testing.pytestEnabled": true,
    "python.testing.pytestArgs": [
        "tests/", // 改成你实际的测试目录，比如"myapp/tests/"
        "--ds=myproject.settings" // 替换成你的Django项目settings模块名
    ],
    "python.analysis.extraPaths": [
        "/workspace/myproject" // 容器内的项目根目录路径，根据你的挂载配置改
    ]
}

--ds参数是关键，告诉pytest用哪个Django配置，必须和容器里运行Django时的一致。

2. 容器内配置.env文件 #

在容器里的项目根目录创建.env文件，直接指定容器内的PYTHONPATH：

PYTHONPATH=/workspace/myproject

路径要和你Docker挂载的项目路径完全一致，比如本地./myproject挂到容器/app/myproject，就写/app/myproject。

三、统一测试文件的导入方式 #

测试文件里全部用绝对导入，比如：

from myapp.models import MyModel

别用相对导入（from .models import ...），虽然Django运行时没问题，但VSCode调试pytest时容易因为路径识别出错。

四、配置调试launch.json #

在.vscode/launch.json里加pytest的调试配置，确保在容器环境运行：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Pytest: Django Tests",
            "type": "python",
            "request": "launch",
            "module": "pytest",
            "args": [
                "tests/",
                "--ds=myproject.settings"
            ],
            "envFile": "${workspaceFolder}/.env",
            "justMyCode": false
        }
    ]
}

${workspaceFolder}就是容器内的项目根目录，自动识别不用改。

五、指定容器内的pytest路径 #

在容器终端跑which pytest，得到pytest的绝对路径（比如/usr/local/bin/pytest），然后加到settings.json里：

"python.testing.pytestPath": "/usr/local/bin/pytest"

避免VSCode误用到本地的pytest版本。

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