GitHub Actions中go test卡住主因是未设超时及遗留goroutine，须加-timeout 60s、用httptest.NewUnstartedServer、跳过真实DB连接；发布失败因路径权限错，需清理dist并设GITHUB_TOKEN写权限；私有模块拉取失败因漏配GOPRIVATE和go.sum缓存key。
GitHub Actions 跑不起来、测试挂住、二进制发不到 Releases、私有模块拉不到——不是 Go 项目难配 CI/CD，是默认模板漏了关键约束。
go test 在 CI 里卡住或超时，根本原因不是慢，是没设 timeout
本地秒过，CI 里跑一半不动，大概率是测试里起了没关的 http.Server 或 goroutine。GitHub Actions 默认不限制单个命令执行时间（上限 6 小时），但你等不起。
- 所有
go test命令必须加-timeout 60s，别信“我这测试很短”——磁盘 IO、DNS 解析延迟在 CI 环境会被放大 - HTTP 测试用
httptest.NewUnstartedServer+srv.Start()+defer srv.Close()，别写http.ListenAndServe - 数据库测试跳过真实连接：用
file::memory:或testcontainers-go；若必须连，加-short - 删掉所有
time.Sleep，改用sync.WaitGroup或 channel 等待条件达成
交叉编译产物发不到 GitHub Releases，多半是路径或权限没对上
softprops/action-gh-release 只认 ./dist/* 下的文件，且依赖 GITHUB_TOKEN 的 packages: write 权限（默认 workflow token 已带，不用额外配）。
- 发布前先清空：
rm -rf ./dist && mkdir -p ./dist，否则上次残留文件会被一起推上去 - 构建时显式指定输出名，带平台标识：
GOOS=linux GOARCH=amd64 go build -o ./dist/myapp-linux-amd64 - 确保
on: push: tags触发，且 tag 是附注型（git tag -a v1.2.3 -m "release"），轻量 tag 不触发 workflow - 检查
.github/workflows/*.yml中是否漏了permissions: contents: write（新版 Actions 默认不给写权限）
私有模块（如 gitlab.com/org/repo）在 CI 里报 cannot find module
错误信息像 cannot load package: package xxx: cannot find module providing package xxx，本质是 go mod download 阶段找不到私有域名对应的代理或认证配置。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 必须在 job 开头设
GOPRIVATE=gitlab.com/org/*（支持通配），否则 go 命令会强行走 proxy.golang.org - 若私有 Git 服务需要认证，加
git config --global url."https://token:x-oauth-basic@github.com/".insteadOf "https://github.com/"类似配置 -
go mod download步骤要放在go test之前，避免网络抖动导致超时失败被误判为模块缺失 - 别依赖
go test ./自动扫描——它可能误入含// +build windows的目录，在 Linux runner 上失败
缓存没生效，每次重下依赖，CI 耗时翻倍
默认模板常漏掉 go.mod 和 go.sum 的缓存 key 设计，导致即使依赖没变，也反复拉包。
- 用
actions/cache@v4缓存$HOME/go/pkg/mod，key 必须包含go.sum的 hash：${{ hashFiles('**/go.sum') }} - 别用
stable当go-version，它长期不更新；明确写死如'1.22'，否则 setup-go 可能复用旧版缓存 - 确保
go mod download在缓存步骤之后、测试之前运行，且不在if: steps.cache.outputs.cache-hit != 'true'分支里绕过 - 避免在 CI 中执行
go install到全局——它依赖GOPATH/bin，而 Actions 默认不设 GOPATH，改用go build -o ./bin/app
最易被忽略的是 GOPRIVATE 和 go.sum 缓存 key 的耦合：私有模块变更后，go.sum 必然变化，但若缓存 key 没包含它，就会命中旧缓存，导致构建用错版本。
