在VSCode中配置Docker容器化Python开发调试-VSCode-PHP中文网

devcontainer.json必须置于项目根目录下.devcontainer/路径，且至少包含image、build或customizations.vscode.extensions之一；漏配forwardports导致端口不可访问，缺remoteuser和runargs则引发git/pip权限失败。

在vscode中配置docker容器化python开发调试

devcontainer.json 必须放对位置、字段不能少

VSCode 只识别项目根目录下 .devcontainer/devcontainer.json 这一个路径，放错地方（比如放在 .vscode/ 或项目根目录平级）就完全没反应。构建卡在 “Building image…” 或进容器后没终端、没插件，大概率是漏了关键字段。

以下三个字段至少得有其一：

"image"：快速验证用，例如 "mcr.microsoft.com/vscode/devcontainers/python:3.11-bullseye"
"build"：要加系统级依赖（如 libpq-dev、curl）时必须用，且 Dockerfile 必须放在 .devcontainer/Dockerfile，内容需基于 dev-containers/base 或显式安装 vscode-server
"customizations.vscode.extensions"：必须显式列出插件，例如 ["ms-python.python", "ms-python.vscode-pylance"]；容器不会继承你本地装的插件

forwardPorts 不填，Flask/Django 就等于白跑

你在容器里执行 flask run --port=5000，宿主机浏览器打不开 localhost:5000？八成是漏了 "forwardPorts": [5000]。这不是可选功能，是调试刚需。

不填，端口默认不暴露，curl localhost:5000 在宿主机上直接失败
多个服务要同时调试？写成数组，例如 [5000, 8000, 3000]
填了还连不上？先确认容器内服务监听的是 0.0.0.0:5000，不是 127.0.0.1:5000

remoteUser + runArgs 是文件权限问题的唯一稳解

新建的 Python 文件在 VSCode 里显示属主为 root:root，但 git status 却报 permission denied？这是最常被忽略的权限断裂点。

A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.

调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。

下载

根本原因是宿主机 UID（比如 1001）和容器内默认用户（通常是 root）不匹配。解决方式只有一套组合拳：

在 devcontainer.json 中加这两行：
"remoteUser": "vscode"
"runArgs": ["--user", "vscode"]
如果用了自定义 Dockerfile，必须在里面创建该用户并加进 sudo 组：
RUN useradd -m -u 1001 -G sudo vscode
别设 "remoteUser": "root"：虽然能过构建，但所有生成文件都是 root:root，后续协作时 git commit 会因权限拒绝失败

调试配置要分清 attach 和 launch 场景

容器内调试 Python 分两类：一类是启动即调试（launch），一类是附加到已运行进程（attach）。别混用。

用 devcontainer.json 启动容器后，想直接跑 main.py 并断点？配 launch.json 的 "type": "python"，配合 "module": "flask" 或 "args" 参数
服务已在容器里跑着（比如 gunicorn 或后台 celery），你想临时 attach 调试？用 "type": "debugpy" + "request": "attach"，确保容器内已暴露 5678 端口并运行 debugpy
常见错误：Connection refused —— 检查容器是否真的监听了 0.0.0.0:5678，而不是仅 127.0.0.1:5678；也确认 forwardPorts 包含 5678