必须用多阶段Dockerfile而非宿主机go build，因其锁定golang版本、避免环境漂移、通过CGO_ENABLED=0和GOOS=linux确保跨平台兼容，并利用层缓存加速依赖下载。
直接用 docker build + go build 多阶段构建，配合 Jenkins 或 GitLab CI 触发，是最轻量、最可控的 Golang 微服务 CI 环境。别在 Jenkins 宿主机装 Go 环境，也别让构建产物污染工作区——所有编译都该在 Docker 镜像里完成。
为什么必须用多阶段 Dockerfile 而不是宿主机 go build
宿主机构建会引入环境漂移：本地 GOPATH、GOVERSION、proxy 设置、模块缓存位置不一致，CI 机上还可能缺 git 或 ca-certificates，导致 go get 失败或证书校验失败。而多阶段构建把整个 Go 构建链封装进镜像，FROM golang:1.22-alpine AS builder 这一行就锁定了工具链版本和基础依赖。
-
CGO_ENABLED=0必须加，否则默认链接 glibc，在 alpine/scratch 镜像中运行时会报no such file or directory -
GOOS=linux必须显式指定，尤其在 macOS 或 Windows 上构建时容易遗漏，导致生成的二进制无法在 Linux 容器中执行 - 构建阶段只 COPY
go.mod和go.sum再go mod download，能利用 Docker 层缓存加速依赖下载，比全量 COPY 源码再go build更快更稳定
Jenkins Pipeline 中如何安全调用 docker build
Jenkins 节点必须安装 Docker 引擎并允许 jenkins 用户执行 docker 命令（通常加到 docker 用户组），但绝不能直接用 sh 'docker build ...' 在全局环境执行——这会绕过 Jenkins 的 workspace 隔离，且无法清理中间镜像。
- 推荐用
docker.withRegistry('https://your-registry.com')+docker.build('myapp:${BUILD_ID}')，由 Jenkins Docker Plugin 管理生命周期 - 构建前加
sh 'docker system prune -f --filter "until=24h"'清理陈旧镜像，避免磁盘爆满 - 禁止在
sh步骤里写docker run -v $(pwd):/src ...这类挂载，Jenkins workspace 路径在不同节点不一致，挂载会失败
Dockerfile 里 HEALTHCHECK 怎么写才不误判
Go 服务启动有延迟（加载配置、连 DB、注册服务发现），HEALTHCHECK 过早探测会反复失败，触发容器重启。它不是可选项，而是 Kubernetes 滚动更新和负载均衡生效的前提。
立即学习“go语言免费学习笔记（深入）”；
- 用
wget --quiet --tries=1 --spider http://localhost:8080/health，Alpine 默认不含curl，wget更可靠 -
--start-period=45s是关键，给 Go 应用留足初始化时间；若服务依赖外部组件（如 Etcd），这个值得拉长到 60–90s - Go 程序必须监听
0.0.0.0:8080，监听127.0.0.1:8080会导致 HEALTHCHECK 在容器内访问失败 - HTTP handler 返回状态码必须是 200，不要返回 204 或重定向，Kubernetes 的 readiness probe 只认 2xx
最容易被忽略的是 GOOS 和 CGO_ENABLED 的组合效果——漏掉任一，构建出来的二进制在目标容器里根本跑不起来，错误信息却只显示 exec format error 或空 panic，查半天才发现是平台不匹配。
