如何在VSCode中创建和管理Docker容器？容器化开发入门【教程】

vscode 依赖本地 docker CLI 执行容器操作，必须先安装并启动 Docker 引擎，验证 docker –version 可用；再安装官方 Docker 扩展和配置 Dev Containers 实现容器化开发。

vscode 本身不直接创建或运行 docker 容器，它通过扩展与 docker cli 协同工作——真正执行容器操作的是你本地已安装的 docker 命令行工具。没装 docker desktop（macos/windows）或 docker-ce（linux），vscode 扩展再强也启动不了容器。

必须先确认 docker 命令可用

这是所有后续操作的前提，也是新手最容易卡住的第一步。

• 终端中运行 docker --version，有输出说明 CLI 已就绪；若报 command not found 或 Cannot connect to the Docker daemon，需先安装并启动 Docker 引擎
• linux 用户注意：还需把当前用户加入 docker 用户组（sudo usermod -aG docker $USER），否则会因权限不足被拒绝
• VSCode 内置终端（Ctrl+`）默认不会自动加载 shell 配置，如果 docker 在 zsh/bash 中可用但在 VSCode 终端里不可用，检查 "terminal.integrated.defaultProfile.linux" 等设置是否指向了正确 shell

安装 Docker 扩展并连接到本地引擎

VSCode 的官方 Docker 扩展（由 microsoft 发布）提供侧边栏容器/镜像管理、Dockerfile 高亮、命令快捷入口等功能，但它只是“遥控器”，不是“发动机”。

• 在扩展市场搜索并安装 Docker（发布者：Microsoft）
• 安装后重启 VSCode，左侧活动栏会出现鲸鱼图标；若图标灰显或提示 “No Docker daemon detected”，说明扩展找不到 docker 可执行文件或守护进程未响应
• 扩展默认使用 DOCKER_HOST 环境变量或 unix socket（/var/run/docker.sock）连接本地引擎，不支持直接配置远程 Docker 主机（如云服务器上的 Docker）——如需远程，得靠 ssh 隧道或 docker context 配合本地 CLI

用 Dev Containers 实现一键容器化开发环境

这才是 VSCode 在容器化开发中最实用的功能：把整个开发环境（含依赖、工具链、端口映射）定义在代码仓库中，打开文件夹即自动构建并进入容器内工作。

• 前提：项目根目录存在 .devcontainer/devcontainer.json（可手动创建，也可用命令面板 Dev Containers: Add Development Container Configuration Files... 生成）
• devcontainer.json 中关键字段："image" 指定基础镜像（如 mcr.microsoft.com/vscode/devcontainers/python:3.11），"forwardPorts" 自动转发容器端口到宿主机，"customizations.vscode.extensions" 声明容器内要预装的 VSCode 扩展
• 首次打开时，VSCode 会调用 docker build 构建镜像（如有 Dockerfile），再用 docker run 启动容器，并挂载当前目录为工作区——你编辑的代码实时存在于容器内
• 注意：devcontainer.json 中的 "workspaceFolder" 默认是 /workspace，但某些基础镜像可能没创建该路径，导致挂载失败；可在 postCreateCommand 中加 mkdir -p /workspace 避免

{   "image": "mcr.microsoft.com/vscode/devcontainers/python:3.11",   "forwardPorts": [8000],   "customizations": {     "vscode": {       "extensions": ["ms-python.python"]     }   },   "postCreateCommand": "pip install -r requirements.txt" }

日常调试：容器内进程和端口别被“黑盒”掉

Dev Container 启动后，VSCode 的终端默认进入容器内部，但调试器、http 服务、日志输出等容易因路径/网络/权限错位而失效。

• 调试 Python/node.js 时，确保 launch.json 中的 "cwd" 指向容器内路径（如 /workspace），而非宿主机路径
• Web 服务监听 localhost:8000 在容器内无法被宿主机访问——必须监听 0.0.0.0:8000，且 devcontainer.json 中已声明 "forwardPorts": [8000]
• 容器内生成的日志文件（如 app.log）写在容器文件系统中，关闭容器即丢失；如需持久化，用 "mounts" 字段挂载宿主机目录，例如 "mounts": ["source=/tmp/logs,target=/workspace/logs,type=bind,consistency=cached"]

Dev Containers 不是魔法，它把 docker run 的参数封装进了 JSON，但底层仍是标准 Docker 行为。一旦遇到网络不通、挂载失败或构建卡住，第一反应不应该是查 VSCode 文档，而是打开终端执行 docker ps、docker logs 、docker inspect ——这些原始命令永远比图形界面更诚实。