如何在VS Code中调试Docker容器内的Python脚本？

步骤1：配置launch.json调试文件 #

打开VS Code的调试面板（快捷键Ctrl+Shift+D），点击"创建launch.json文件"，选择Docker -> Python模板（无模板则手动创建），替换为以下配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Docker: 调试目标Python脚本",
            "type": "docker",
            "request": "launch",
            "preLaunchTask": "docker-run: debug",
            "python": {
                "pathMappings": [
                    {
                        "localRoot": "${workspaceFolder}/my_dir",
                        "remoteRoot": "/host"
                    }
                ],
                "program": "/host/api/my_file.py"
            }
        }
    ]
}

步骤2：配置tasks.json任务文件 #

在.vscode目录下新建或修改tasks.json，添加对应Docker运行参数的任务：

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "docker-run",
            "label": "docker-run: debug",
            "dockerRun": {
                "image": "myimage:latest",
                "name": "my_container",
                "rm": true,
                "volumes": [
                    {
                        "localPath": "/my_dir",
                        "containerPath": "/host",
                        "accessMode": "z"
                    }
                ]
            },
            "python": {
                "file": "/host/api/my_file.py"
            }
        }
    ]
}

关键配置对应说明 #

• pathMappings：关联本地my_dir目录与容器内/host路径，保证VS Code能映射本地代码和容器内文件
• dockerRun中的volumes完全匹配原命令的--volume "/my_dir/:/host:z"参数
• program和file指定容器内待调试脚本路径，与原命令的python /host/api/my_file.py一致

启动调试 #

回到调试面板，选择"Docker: 调试目标Python脚本"配置，点击绿色启动按钮，即可像调试本地脚本一样在容器内打断点、查看变量、单步执行。

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