Docker中如何构建Golang开发环境 容器化开发方案

Dockerfile

docker-compose

Dockerfile

# Dockerfile
FROM golang:1.22.2-alpine3.19 # 我个人偏爱Alpine，因为它小巧，但你也可以用Debian系的

WORKDIR /app # 设置工作目录，这是Go项目代码在容器里的家

# 拷贝go.mod和go.sum，并下载依赖，这样可以利用Docker的缓存机制
# 如果依赖不变，下次构建就不用重新下载了，这对我来说是个效率提升点
COPY go.mod go.sum ./
RUN go mod download

# 拷贝所有项目文件
COPY . .

# 暴露端口，如果你有Web服务的话
EXPOSE 8080

# 定义一个默认命令，方便直接运行
# 但在开发时，我们通常会通过挂载卷的方式，在本地修改代码后直接在容器内执行
CMD ["go", "run", "main.go"]

docker-compose.yml

# docker-compose.yml
version: '3.8' # 我通常用3.8，比较稳定

services:
  go_app:
    build:
      context: . # 指向Dockerfile所在的目录
      dockerfile: Dockerfile
    volumes:
      - .:/app # 关键！把本地当前目录挂载到容器的/app目录，实现代码同步
    ports:
      - "8080:8080" # 如果你的Go应用监听8080端口
    environment:
      # 你可以在这里设置一些环境变量，比如数据库连接字符串，这对开发来说很方便
      - MY_ENV_VAR=some_value
    # command: go run main.go # 你也可以在这里覆盖Dockerfile的CMD
    # 或者如果你想进入容器内部操作，可以省略command，然后用docker exec进入

docker-compose up -d

docker exec -it <容器ID或名称> bash

go run

go build

docker-compose exec go_app go run main.go

docker-compose up

Dockerfile

go.mod

go.sum

Dockerfile

# Dockerfile (片段)
# ...
RUN go install github.com/go-delve/delve/cmd/dlv@latest # 安装Delve
# ...
EXPOSE 2345 # 暴露Delve的默认端口

docker-compose.yml

# docker-compose.yml (片段)
services:
  go_app:
    # ...
    ports:
      - "2345:2345" # 映射Delve端口
    command: ["dlv", "dap", "--listen=:2345", "--api-version=2", "--headless=true", "--log=true", "--accept-multiclient", "main.go"]
    # 或者如果你想调试编译后的二进制文件
    # command: ["dlv", "exec", "--listen=:2345", "--api-version=2", "--headless=true", "--log=true", "--accept-multiclient", "./your_binary_name"]

localhost:2345

launch.json

// .vscode/launch.json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Connect to Go App in Docker",
            "type": "go",
            "request": "attach",
            "mode": "remote",
            "remotePath": "/app", // 容器内你的项目路径
            "port": 2345,
            "host": "127.0.0.1"
        }
    ]
}

dlv

FROM golang:latest

COPY . .

go build

scratch

alpine

Dockerfile

# Dockerfile (多阶段构建)

# --- 阶段 1: 构建阶段 ---
FROM golang:1.22.2-alpine3.19 AS builder # 给这个阶段起个名字叫 'builder'

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY . .

# 编译Go应用程序，生成一个静态链接的二进制文件
# CGO_ENABLED=0 是为了确保编译出来的二进制文件不依赖C库，可以更独立地运行
# -o app 指定输出文件名为 app
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix nocgo -o app .

# --- 阶段 2: 运行阶段 ---
FROM alpine:latest # 或者 FROM scratch (如果你的Go应用没有其他系统依赖)
# FROM scratch 是最小的镜像，没有任何文件，只有内核
# Alpine 提供了少量基础工具，比如ca-certificates，对于HTTPS请求可能需要

WORKDIR /root/

# 从构建阶段拷贝编译好的二进制文件
COPY --from=builder /app/app .

# 如果你的应用需要CA证书来做HTTPS请求，可以考虑拷贝
# COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/

CMD ["./app"] # 运行你的应用程序

alpine

scratch