go test必须通过且加-race和-covermode=count，CI中需统一GOOS=linux构建环境，Docker多阶段必须设CGO_ENABLED=0并用alpine作运行镜像，K8s部署须配置探针、不可变镜像tag及声明式交付。
go test 通过后才能进流水线，否则直接失败——这是 Golang CI/CD 最硬的门槛。Go 的静态编译和模块化特性让交付链路天然轻量，但陷阱往往藏在构建一致性、镜像瘦身和部署原子性里。
CI 阶段：为什么 go test 要加 -race 和 -covermode=count
默认 go test 只跑单元测试，不触发竞态检测，也不采集覆盖率数据，这会导致线上出现 goroutine 泄漏或条件分支未覆盖的问题。
-
go test -race ./...必须开启：它会动态插桩内存访问，捕获 data race（尤其在 HTTP handler 或定时任务中高频出现） -
go test -covermode=count -coverprofile=coverage.out ./...是覆盖率基线：后续可对接gocov或codecov做门禁（例如要求service/目录覆盖率 ≥80%） - 避免在 CI 中用
go run main.go启服务做集成测试——应改用httptest.NewServer或testify/mock隔离依赖 - 本地
GOOS=linux go build和 CI 中的构建环境必须一致：建议统一用golang:1.21-alpine基础镜像，防止因cgo或net包行为差异导致构建成功但运行失败
Docker 构建：为什么多阶段构建里不能省掉 CGO_ENABLED=0
Go 默认启用 cgo，一旦依赖 net 或 os/user，二进制就会动态链接 libc；Alpine 镜像没有 glibc，直接 panic。
- 构建阶段必须显式设置
CGO_ENABLED=0：RUN CGO_ENABLED=0 go build -a -ldflags '-s -w' -o service cmd/api/main.go -
-s -w去除符号表和调试信息，可让二进制缩小 30–50%，对容器启动速度有实际影响 - 基础镜像选
alpine:latest而非scratch：Alpine 提供sh和ca-certificates，方便调试网络请求或 TLS 握手失败问题 - 禁止把
go.mod和源码一起 COPY 到最终镜像：只 COPY 编译好的二进制 +/etc/ssl/certs，否则镜像体积翻倍且暴露敏感路径
CD 阶段：Kubernetes 部署时 imagePullPolicy 为什么不能设为 Always
设成 Always 看似保险，但会绕过镜像层缓存，每次拉取完整镜像，拖慢滚动更新速度，还可能因 registry 网络抖动导致 Pod 卡在 ImagePullBackOff。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 生产环境一律用
imagePullPolicy: IfNotPresent，前提是镜像 tag 是不可变的（推荐用 git commit hash，如sha-abc1234） - Deployment 中必须配置
readinessProbe和livenessProbe，端点用/healthz而非/：避免因路由中间件未就绪就上报存活 - 镜像仓库地址不要硬编码在 YAML 里，改用 Helm
{{ .Values.image.repository }}或 Kustomizeimages:字段注入，便于多环境切换 - 禁止在容器内执行
go build或go mod download：所有构建动作必须在 CI 完成，CD 阶段只做声明式部署
GitOps 同步失败时，argocd app sync 报 ComparisonError 怎么查
这不是 Argo CD 的 bug，而是 Go 服务的 Kubernetes manifest 和实际集群状态存在语义冲突，比如 CRD 版本不匹配或 RBAC 规则被手动修改过。
立即学习“go语言免费学习笔记（深入）”；
- 先运行
kubectl get app -n argocd <app-name> -o yaml，检查status.sync.status和status.health.status字段 - 重点看
status.sync.revision是否等于你 Git 仓库中main分支的 HEAD commit；如果不是，说明 Argo CD 没拉到最新配置 - 执行
argocd app diff <app-name>查差异：常见是 Go 服务的env变量名拼写错误（如DB_URL写成DB_ULR），或资源 limit/request 不满足 namespace 的ResourceQuota - 不要直接
kubectl edit修改线上 Deployment——Argo CD 会立刻 revert，应在 Git 仓库修正后触发自动同步
git push 都能对应一个可验证、可回滚、可观测的交付单元。镜像 tag、commit hash、deployment revision 这三者必须严格绑定，缺一不可。 
