VS Code 中使用 Docker 容器进行开发

在设置中修改镜像存放位置（如果 C 盘空间足够可不更改）。接着打开终端，验证 docker 能够正常拉取镜像。

2.2 配置 VS Code

2.2.1 安装 Docker 插件

1. 打开 VS Code，进入扩展面板（快捷键 Ctrl+Shift+X 或 Cmd+Shift+X）。
2. 搜索'Docker'，选择微软官方的'Docker'插件（作者为 Microsoft），点击'安装'。
3. 安装完成后，VS Code 左侧会出现 Docker 图标，可通过该面板管理镜像、容器等。

此时 VS Code 应已自动连接上 Docker。

2.2.2 配置 Docker 连接

Docker 插件默认会自动连接本地 Docker 服务，若需连接远程 Docker 服务，可按以下步骤：

1. 打开 VS Code 设置（Ctrl+, 或 Cmd+,）。
2. 搜索'docker.host'，设置远程 Docker 服务地址（如 tcp://remote-host:2375）。
3. 重启 VS Code 使配置生效。

3 VS Code 中使用 Docker 的核心操作

3.1 创建 Dockerfile

3.1.1 新建 Dockerfile

1. 在 VS Code 中打开项目文件夹，右键新建文件，命名为 Dockerfile（无扩展名）。
2. 输入基础指令：

# 基础镜像
FROM python:3.9-slim
# 设置工作目录
WORKDIR /app
# 复制项目依赖文件
COPY requirements.txt .
# 安装依赖
RUN pip install --no-cache-dir -r requirements.txt
# 复制项目代码
COPY . .
# 暴露端口（若项目有服务）
EXPOSE 5000
# 启动命令
CMD ["python", "app.py"]

在运行程序之前，需要确保你的项目目录下需要有 requirements.txt 文件（用于记录 Python 项目的依赖包），如果没有实际依赖，可以创建一个空的 requirements.txt 文件。项目目录下还需要有 app.py 文件。

app.py 文件内容如下：

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'Hello, Docker!'

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

3.1.2 Dockerfile 指令说明

• FROM：指定基础镜像，必须为 Dockerfile 的第一条指令。
• WORKDIR：设置后续指令的工作目录。
• COPY：将本地文件复制到镜像中。
• RUN：在镜像构建过程中执行命令。
• EXPOSE：声明容器运行时暴露的端口（仅为文档说明，需配合 -p 参数映射）。
• CMD：指定容器启动时执行的命令（可被 docker run 后的命令覆盖）。

3.2 构建 Docker 镜像

3.2.1 基于 Dockerfile 构建

1. 打开 VS Code 终端（Ctrl+\`` 或 Cmd+``）。
2. 执行构建命令：

docker build -t my-python-app:1.0 .

• -t：指定镜像标签（格式为 名称：版本）。
• .：表示 Dockerfile 所在的当前目录。

构建完成后，可在 VS Code 的 Docker 面板 Images 中看到新构建的镜像。

3.2.2 查看镜像信息

在 VS Code Docker 面板中，右键镜像选择'Inspect'，可查看镜像的详细配置（如层信息、环境变量等）；或在终端执行：

docker images my-python-app:1.0

3.3 运行 Docker 容器

3.3.1 基础运行命令

在终端执行：

docker run -d -p 5000:5000 --name my-app-container my-python-app:1.0

• -d：后台运行容器。
• -p 5000:5000：将容器的 5000 端口映射到主机的 5000 端口（主机端口：容器端口）。
• --name：指定容器名称。

3.3.2 在 VS Code 中管理容器

1. 打开 Docker 面板，在 Containers 中可看到运行中的容器。
2. 右键容器可执行'Start''Stop''Restart''Delete'等操作。
3. 选择'Attach Shell'可进入容器内部终端；选择'View Logs'可查看容器运行日志。

3.4 调试容器内的应用

3.4.1 配置调试环境

1. 在 VS Code 中创建 .vscode/launch.json 文件，添加 Docker 调试配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Docker: Python - Launch",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "docker-build",
      "python": {
        "pathMappings": [
          {
            "localRoot": "${workspaceFolder}",
            "remoteRoot": "/app"
          }
        ],
        "projectType": "general"
      }
    }
  ]
}

此配置用于在 VS Code 中直接调试 Docker 容器内的 Python 代码。通过路径映射，让 VS Code 知道本地代码和容器内代码的对应关系。

2. 创建 .vscode/tasks.json 文件，定义构建任务：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "docker-build",
      "type": "docker-build",
      "dockerBuild": {
        "context": "${workspaceFolder}",
        "tag": "my-python-app:1.0"
      }
    }
  ]
}

此文件将 Docker 构建命令固化成 VS Code 的一个任务，方便与调试流程联动。

3.4.2 启动调试

1. 可以在程序中设置断点（点击行号左侧）。
2. 按 F5 启动调试，或者在左侧选择'运行和调试'，VS Code 会自动构建镜像、运行容器并附加调试器，程序执行到断点时会暂停，可查看变量、调用栈等信息。

4 小结

本文介绍了在 VS Code 中使用 Docker 的全流程。首先明确了 Docker 与 VS Code 集成的价值——解决环境一致性问题并提升开发效率；接着讲解了镜像、容器等核心概念，以及 Docker 和 VS Code 的安装配置；然后通过实例演示了 Dockerfile 编写、镜像构建、容器运行及调试的具体操作。

掌握这些知识后，可在 VS Code 中高效完成容器化开发，无论是单服务应用还是多组件协同项目，都能通过 Docker 实现环境隔离与快速部署，显著提升开发体验和项目可维护性。