go test -cover 通过编译前源码插桩统计覆盖率，即在每个基本块入口插入计数语句，运行后计算被触发块数占比；它依赖源码结构，需重新运行测试更新数据，且仅覆盖被测试编译的代码。
go test -cover 是怎么算出覆盖率的
它不是运行时采样，而是编译前对源码插桩——在每个基本块（basic block）入口插入 CoverageVariableName.Count[i]++ 语句，再编译执行。最终统计的是这些计数器被触发的次数占总块数的比例。
这意味着：覆盖率数据依赖源码结构，不是二进制行为；修改代码后必须重新运行 go test -cover，旧的 coverage.out 文件不会自动更新；插桩会略微拖慢测试执行速度，但影响通常可忽略。
- 插桩只作用于被
go test编译的代码，vendor/或未被导入的包不计入 -
-covermode=count（默认）记录每块执行次数，-covermode=atomic用于并发测试避免竞态 - 生成的
coverage.out是二进制格式，需用go tool cover解析，不能直接读
为什么 go test 不递归运行子目录测试
go test 默认只扫描当前目录下匹配 *_test.go 的文件，不自动进入子目录——这是设计使然，不是 bug。想覆盖整个模块，得显式加 ./... 或 ./。
常见误操作是：在项目根目录执行 go test，结果只跑顶层 main_test.go，而 pkg/utils/utils_test.go 完全没被执行。
立即学习“go语言免费学习笔记（深入）”；
-
go test ./...：递归所有子目录（含嵌套模块） -
go test ./... -run ^TestValidate$：只跑匹配正则的测试函数，仍保持递归范围 -
go test ./pkg/...：限定递归范围到pkg/下，跳过cmd/和internal/
Makefile 封装 go test 容易漏掉的关键参数
很多团队用 make test 看似省事，但常漏掉 -v 和 -coverprofile，导致失败时看不到具体哪个测试挂了，也无法生成报告。
更隐蔽的问题是：没加 -count=1。Go 1.20+ 默认 -count=1，但某些旧 Makefile 会写成 -count=3 用于稳定性验证——这会让覆盖率数值虚高（同一块被重复计数），且掩盖单次执行就失败的 flaky test。
- 推荐写法：
go test -v -covermode=count -coverprofile=coverage.out -count=1 ./... - 若需调试，加
-failfast让第一个失败就停，避免冗长输出淹没关键信息 - 注意
coverage.out路径应写绝对路径或确保go tool cover执行时 cwd 正确，否则解析报错
Docker 中运行 go test 需绕开 musl libc 兼容性坑
用 golang:alpine 镜像跑测试时，如果代码里用了 cgo（比如 net 包调 DNS、sqlite3、某些数据库驱动），go test 可能静默失败或 panic，错误常表现为 exec format error 或 undefined symbol: getaddrinfo。
这不是 Go 本身问题，而是 Alpine 默认的 musl libc 和 glibc 行为差异所致。即使你禁用了 CGO_ENABLED=0，某些标准库仍隐式依赖 cgo。
- 验证方式：在容器内执行
go env CGO_ENABLED，确认值为0 - 稳妥方案：改用
golang:1.22-bookworm（Debian）做构建阶段，或显式加CGO_ENABLED=0到go test命令前 - CI 场景下，别依赖本地
docker-compose up test的输出——要检查容器 exit code，0才代表测试通过
