Go项目Docker开发核心是容器内go命令正确编译调试与宿主机协同，需确保go.mod在WORKDIR根路径、GO111MODULE=on、路径挂载一致，避免go run main.go绕过模块校验。
Go 项目在 Docker 容器中开发，核心不是“让 Go 支持 Docker”，而是让 go 命令能在容器内正确编译、调试、依赖管理，同时与宿主机协同工作。关键在于环境隔离、路径映射和构建模式的选择。
如何配置 go.mod 与 GOPATH 在容器内生效
现代 Go 项目（1.11+）默认启用模块模式，go.mod 是唯一权威依赖声明。容器内无需设置 GOPATH，但必须确保：
-
go.mod文件存在于工作目录根路径，且GO111MODULE=on（Go 1.16+ 默认开启，旧版本需显式设置） - 容器启动时挂载的宿主机路径，要与
WORKDIR一致，否则go build找不到go.mod - 若使用
go run main.go而非go run .，会绕过模块校验，导致依赖解析失败
Dockerfile 中多阶段构建的典型写法
生产镜像应分离构建环境与运行环境，避免将 go 编译器、源码、测试工具等打入最终镜像。常见错误是直接用 golang:alpine 作为基础镜像运行服务，导致镜像臃肿且含不必要的构建工具。
FROM golang:1.22-alpine AS builder WORKDIR /app COPY go.mod go.sum ./ RUN go mod download COPY . . RUN CGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o /usr/local/bin/myapp . FROM alpine:latest RUN apk --no-cache add ca-certificates WORKDIR /root/ COPY --from=builder /usr/local/bin/myapp . CMD ["./myapp"]
注意：CGO_ENABLED=0 是为了生成纯静态二进制，避免 Alpine 上缺少 glibc；若项目依赖 cgo（如 net 包在某些场景下），则需改用 gcr.io/distroless/static 或保留 glibc 的基础镜像。
立即学习“go语言免费学习笔记（深入）”；
本地开发时如何热重载并保持调试能力
容器内无法直接使用 IDE 的调试器，但可通过挂载源码 + 进程管理工具实现近似体验。关键点：
- 使用
docker run -v $(pwd):/app -w /app挂载当前目录，确保修改实时可见 - 避免在 Dockerfile 中
COPY . .后再挂载，否则会覆盖掉构建时的依赖缓存 - 用
air或reflex替代手动go run：安装go install github.com/cosmtrek/air@latest，然后air -c .air.toml，它会监听文件变化并重启进程 - 调试需暴露
dlv端口：docker run -p 2345:2345 -v $(pwd):/app -w /app golang:1.22 sh -c "go install github.com/go-delve/delve/cmd/dlv@latest && dlv debug --headless --listen :2345 --api-version 2 --accept-multiclient"
go test 和覆盖率在容器中怎么跑
容器内执行测试本身无特殊要求，但常见陷阱是：测试依赖本地文件路径、环境变量未透传、或数据库连接地址写死为 localhost（实际应为容器网络中的服务名）。
- 运行测试：
docker run --rm -v $(pwd):/app -w /app golang:1.22 go test -v ./... - 生成覆盖率报告：
docker run --rm -v $(pwd):/app -w /app golang:1.22 sh -c "go test -coverprofile=coverage.out ./..."，再用go tool cover -html=coverage.out查看（需在宿主机执行该命令） - 若测试依赖外部服务（如 Redis、PostgreSQL），应在
docker-compose.yml中定义服务，并在 Go 测试代码中通过os.Getenv("REDIS_URL")获取地址
最易被忽略的是：容器内时间与宿主机不同步可能导致 go mod download 报证书过期错误；还有 Windows/macOS 用户用 Docker Desktop 时，/mnt/wsl 或 /private 路径挂载可能触发文件系统性能问题或 inotify 事件丢失——此时 air 无法检测到保存动作。这些细节不报错，但会让开发流程卡住很久。
