Vscode Docker扩展教程

安装 VSCode Docker 扩展后，通过点击扩展图标搜索并安装由 Microsoft 发布的 Docker 扩展，安装完成后左侧活动栏会出现鲸鱼图标；2. 确保本地已安装并运行 Docker Desktop 或 Docker Engine，通过执行 docker --version 和 docker ps 验证环境是否就绪；3. 使用 Docker 面板查看容器、镜像等资源，通过右键菜单可进行启停、查看日志、进入终端等操作；4. 在项目中右键选择 "Docker: Add Docker Files to Workspace" 可自动生成 Dockerfile 和 docker-compose.yml，并建议包含 .dockerignore 以提升构建效率；5. 构建镜像可通过右键 Dockerfile 选择 "Build Image" 或使用命令面板执行 Docker Build，输入镜像名后即可完成构建；6. 运行容器时可右键镜像选择 "Run" 或使用 "Run with Options" 设置容器名、端口映射、环境变量及挂载卷，推荐将源码目录挂载至容器以实现热更新；7. 调试容器化应用需在 Dockerfile 中开放调试端口（如 Node.js 的 9229），运行时映射该端口，并在 launch.json 中配置附加调试器，启动后按 F5 即可连接；8. 推送镜像前需登录 Docker Hub，右键镜像选择 "Push"，镜像名需符合 username/repo:tag 格式方可成功推送；注意事项包括注意文件路径大小写敏感、合理使用 .dockerignore、利用 docker-compose.yml 管理多服务以及关闭不必要的 Docker 面板视图以减少资源占用，最终实现通过图形化界面高效完成容器开发全流程。

如果你刚接触 VSCode Docker 扩展，想快速上手用它管理容器、构建镜像、调试应用，这篇实用指南会帮你一步步操作，不绕弯子。

1. 安装 Docker 扩展

打开 VSCode：

• 点击左侧活动栏的「扩展」图标（或按 Ctrl Shift X）
• 搜索 "Docker"
• 找到由 Microsoft 官方发布的 "Docker" 扩展（作者：Microsoft）
• 点击安装

✅ 安装后，左侧活动栏会出现一个鲸鱼图标（?），这就是 Docker 面板。

2. 确保本地 Docker 环境就绪

扩展本身只是个界面工具，真正运行容器的是 Docker Engine。

你需要先：

• 安装 Docker Desktop（Windows/macOS）
• 或在 Linux 上安装 Docker Engine（如 docker-ce）
• 启动 Docker 服务（Docker Desktop 要保持运行）

测试是否正常：

docker --version
docker ps

如果命令能正常运行，VSCode 扩展就能连接上。

3. 使用 Docker 扩展查看和管理容器

点击左侧的鲸鱼图标，你会看到：

• Containers：当前运行/停止的容器
• Images：本地镜像
• Volumes / Networks / Registries：其他资源

常用操作（右键菜单）：

• 启动/停止容器
• 查看日志（Logs）
• 进入终端（Attach Shell）
• 删除容器或镜像

? 小技巧：点击容器的日志图标，会在右侧新开一个输出面板，实时看日志，比命令行还方便。

4. 快速生成 Dockerfile 和 docker-compose.yml

VSCode Docker 扩展可以帮你自动生成配置文件。

生成 Dockerfile

1. 在项目根目录，右键点击空白处或某个文件
2. 选择 "Docker: Add Docker Files to Workspace"
3. 选择应用类型（如 Node.js、Python、.NET 等）
4. 指定端口（比如 3000）
5. 是否包含 .dockerignore？建议选是

它会自动生成：

• Dockerfile
• .dockerignore

生成 docker-compose.yml

继续向导，它会问你是否要添加 docker-compose.yml，选是即可。

生成的 compose 文件默认配置一个服务，适合开发环境。

5. 构建镜像

方法一：右键 Dockerfile

• 在资源管理器中右键你的 Dockerfile
• 选择 "Build Image"
• 输入镜像名，比如 myapp:latest
• 回车构建

方法二：使用命令面板

• Ctrl Shift P → 输入 "Docker Build"
• 选择对应选项

构建完成后，你能在 Images 列表里看到新镜像。

6. 运行容器

右键刚构建好的镜像 → 选择 "Run"

或者点击运行时设置选项（Run with Options），可以：

• 指定容器名
• 映射端口（如 -p 3000:3000）
• 设置环境变量
• 挂载卷（推荐用于开发，实现代码热更新）

✅ 推荐开发时挂载源码目录：

Host: ${workspaceFolder} → Container: /usr/src/app

这样你改代码，容器里实时生效。

7. 调试容器化应用（以 Node.js 为例）

如果你想在容器里调试代码：

1. 确保 Dockerfile 暴露调试端口（如 Node 的 --inspect=0.0.0.0:9229）
2. 运行容器时映射 9229 端口
3. 在 .vscode/launch.json 添加调试配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Attach to Node.js Docker",
      "type": "node",
      "request": "attach",
      "port": 9229,
      "address": "localhost",
      "localRoot": "${workspaceFolder}",
      "remoteRoot": "/usr/src/app",
      "protocol": "inspector"
    }
  ]
}

4. 启动容器后，按 F5 连接调试器

8. 推送镜像到仓库（如 Docker Hub）

1. 确保你已登录：

   docker login

2. 右键镜像 → "Push"
3. 镜像名需符合格式：username/repo:tag

比如：

yourname/myapp:latest

推送后就能在其他机器拉取运行。

小贴士（容易忽略的点）

• 文件路径大小写敏感：Linux 容器对路径大小写敏感，Windows 用户注意。
• .dockerignore 很重要：避免把 node_modules、.git 打进镜像，加快构建。
• Compose 多服务开发：可以用 docker-compose.yml 同时启动 app db（如 PostgreSQL、MongoDB）。
• 资源占用：左侧 Docker 面板可以关闭不常用的视图，减少卡顿。

基本上就这些。
VSCode Docker 扩展的核心价值是：让你不用记太多命令，点点鼠标就能构建、运行、查看日志，特别适合开发阶段快速迭代。

熟练后，你可以继续结合 Dev Containers（开发容器）做更高级的开发环境隔离。但那是下一篇文章的事了。

以上是Vscode Docker扩展教程的详细内容。更多信息请关注PHP中文网其他相关文章！