VSCode中Docker插件配置与容器化开发调试指南-VSCode-PHP中文网

vscode的docker插件仅是docker cli的图形界面，不负责开发环境搭建；真正实现容器化开发调试的是remote-containers扩展配合正确的devcontainer.json配置。

vscode中docker插件配置与容器化开发调试指南

VSCode 的 Docker 插件本身不负责开发环境搭建，它只是 docker CLI 的图形界面；真正支撑容器化开发调试的是 Remote - Containers 扩展 + 正确的 devcontainer.json 配置。

这不是插件坏了，而是它根本没连上本地 dockerd。常见现象包括：侧边栏空、右键“Build Image”报 Cannot connect to the Docker daemon、Exec in Container 无响应。

先在终端运行 docker info —— 报错就说明 Docker Desktop（或 dockerd）根本没启动
Linux 用户检查 groups 输出是否含 docker；不含就执行 sudo usermod -aG docker $USER，然后彻底退出重登
macOS / Linux 下从桌面图标启动 VS Code 会丢失 $PATH 和 DOCKER_HOST 环境变量 —— 必须从终端执行 code . 启动

VS Code 只认项目根目录下 .devcontainer/devcontainer.json 这一个路径。放错（比如丢进 .vscode/ 或平级目录），整个配置完全不生效。

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

必须至少包含以下三者之一："image"（快速验证）、"build"（需自定义依赖时用，且 Dockerfile 必须放在 .devcontainer/Dockerfile）、"customizations.vscode.extensions"（显式声明插件，如 ["ms-python.python"]）
漏掉 "forwardPorts": [5000]，Flask/Django 在容器里跑起来也等于没跑 —— 宿主机 curl localhost:5000 直接失败
服务监听必须是 0.0.0.0:5000，不是 127.0.0.1:5000；否则端口转发成功也连不上

新建 Python 文件在 VS Code 里显示属主为 root:root，但 git status 报 permission denied —— 这是宿主机 UID（如 1001）和容器默认用户（通常是 root）不匹配导致的权限断裂。

在 devcontainer.json 中加两行："remoteUser": "vscode" 和 "runArgs": ["--user", "vscode"]
如果用了自定义 Dockerfile，必须在里面创建该用户并加入 sudo 组：RUN useradd -m -u 1001 -G sudo vscode
不加这组配置，pip install 写入 /home/vscode/.local、git 操作仓库文件都会因权限被拒而失败

很多人以为装了 Docker 插件就能“在容器里写代码”，其实不能。Docker 插件（鲸鱼图标）只管“看容器”，而 Remote - Containers（小电脑+容器图标）才是让你编辑、调试、装扩展的核心工具。

要进容器写代码，必须用 Remote-Containers: Reopen in Container，不是右键容器点 Attach
Attach Visual Studio Code 是给已按 devcontainer 规范启动的容器用的；普通 docker run 启的容器不支持热附加
devcontainer.json 里的 forwardPorts、extensions、postCreateCommand 全部只对 Remote - Containers 生效，Docker 插件完全无视