Windows 上在 VS Code 里构建 Docker 镜像:从环境准备到一键构建

整理在 Windows 上使用 VS Code 构建 Docker 镜像的核心流程,包括环境准备、生成 Dockerfile、镜像构建方式,以及常见排查要点。

如果你想在 Windows 上直接用 VS Code 管理并构建 Docker 镜像,流程其实很短。核心就是三步:先把环境装好,再准备 Dockerfile,最后执行构建。

01 前置准备

先确认两项基础条件:

  1. 安装并启动 Docker Desktop。
  2. 在 VS Code 里安装 Microsoft 官方 Docker 扩展。

在 Windows 上,建议把 Docker Desktop 切到 WSL 2 后端(Settings > Resources > WSL Integration),一般会更稳定、性能也更好。

02 准备 Dockerfile

如果项目里还没有 Dockerfile,可以直接让 VS Code 生成:

  1. 在 VS Code 打开你的项目目录。
  2. F1Ctrl+Shift+P 打开命令面板。
  3. 运行 Docker: Add Docker Files to Workspace
  4. 选择你的平台(例如 Node.js、Python、.NET),按提示完成。

执行后通常会得到至少两个文件:

  • Dockerfile
  • .dockerignore

这一步的价值是先有一个可工作的基础版本,后面再按项目需求微调。

03 构建镜像的三种方式

方式 A:右键 Dockerfile

在资源管理器中右键 Dockerfile,选择 Build Image...,然后输入镜像标签(tag)。

方式 B:命令面板

F1 运行 Docker: Build Image,再按提示选择上下文和标签。

方式 C:集成终端命令

1
docker build -t your-image-name .

这条命令表示用当前目录作为构建上下文,生成名为 your-image-name 的镜像。

04 常见问题快速检查

  • Docker Desktop 没启动:先确认托盘图标显示为运行状态。
  • 构建很慢:优先检查是否启用 WSL 2 后端。
  • 构建失败提示找不到文件:确认执行目录是项目根目录,且 Dockerfile 在上下文内。
  • 扩展看不到 Docker 资源:重启一次 VS Code,或确认 Docker CLI 可用(docker version)。

小结

在 Windows 上用 VS Code 构建 Docker 镜像并不复杂。先安装 Docker Desktop 和 Docker 扩展,再用命令面板生成 Dockerfile,最后用右键或 docker build 即可完成日常构建流程。

记录并分享
使用 Hugo 构建
主题 StackJimmy 设计