gitlab ci 中 go build 失败主因是 runner 使用老旧系统 go 环境且 goroot/go111module 未正确配置；应使用 golang:1.22-alpine 镜像，显式设置 goroot、gopath、path 和 go111module=on，并用 cgo_enabled=0 goos=linux goarch=amd64 交叉编译。
GitLab CI 里 go build 失败：找不到 GOROOT 或 GO111MODULE 行为异常
GitLab Runner 默认用的是系统级 Go 环境（比如 Ubuntu 的 /usr/bin/go），但版本往往老旧，且没配好模块环境。最常见报错是：build: cannot load ...: module requires go 1.18，或 command not found: go（其实有，但 PATH 没生效）。
实操建议：
- 显式指定 Go 版本，用
golang:1.22-alpine这类官方镜像，别依赖系统自带go - 在
.gitlab-ci.yml里加before_script统一设置：export GOROOT=/usr/local/go、export GOPATH=$CI_PROJECT_DIR/go、export PATH=$GOROOT/bin:$PATH - 强制启用模块：
export GO111MODULE=on（Go 1.16+ 已默认开启，但旧 Runner 可能关着） - 避免用
go get下载构建依赖——它会改go.mod，CI 中应只用go build和go test
交叉编译生成 Linux 二进制却在 macOS 本地跑不了
CI 构建目标通常是 Linux AMD64，但开发者常误以为“本地 go build 出来能直接跑”，结果双击没反应、终端报 cannot execute binary file: Exec format error。这不是 bug，是架构不匹配。
实操建议：
-
go build默认按宿主机平台编译；CI 里要明确指定：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp . - 如果项目用了 cgo（比如依赖
netDNS 解析或 SQLite），CGO_ENABLED=0会导致某些功能失效，此时得用alpine基础镜像 +apk add gcc musl-dev编译 - 生成的二进制放在
artifacts下，别指望它能在 macOS 上双击运行——它就是给服务器部署用的
go test 在 CI 里超时或随机失败
本地跑得稳，CI 里 go test -v ./... 却卡住或报 context deadline exceeded，大概率是测试依赖了外部服务（DB、HTTP API）或用了 time.Sleep 模拟等待。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
实操建议：
- 所有集成测试必须加
-short标志，或用if !testing.Short() { ... }包裹耗时操作 - 用
test -short -timeout 60s显式限流，避免单个测试拖垮整个 pipeline - 数据库测试别连真实 PostgreSQL，改用
github.com/ory/dockertest启临时容器，或直接 mocksql.DB - CI 的 CPU 资源比本地低，别写
for i := 0; i 这种纯 CPU 循环测试
怎么让 .gitlab-ci.yml 支持多环境构建（dev/staging/prod）
不是靠写三套 job，而是用 GitLab 的 variables + rules 控制行为差异。很多人硬编码 go build -ldflags="-X main.Version=dev"，结果每次改环境都要推新 commit。
实操建议：
- 用
CI_COMMIT_TAG或CI_COMMIT_BRANCH自动判断环境：rules: - if: '$CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/'触发 prod 构建 - 通过
variables:注入构建参数：VERSION: $CI_COMMIT_TAG、BUILD_ENV: $CI_COMMIT_BRANCH -
go build里用-ldflags注入变量：-ldflags "-X 'main.Version=$VERSION' -X 'main.Env=$BUILD_ENV'" - 别把密钥、API 地址写死在代码里——用
gitlab-ci.yml的protected variables配置，再通过env传给构建命令
真正麻烦的从来不是写几行 go build，而是环境变量怎么透传、模块缓存怎么复用、测试怎么隔离、二进制怎么验签——这些细节不压平，CI 就永远是“看着跑通，上线就崩”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
