go test ./失败90%源于环境未对齐，需确保三件事：工作目录含go.mod、go111module=on强制启用模块模式、模块路径声明与所有import前缀一致。

CI里go test ./失败，90%不是代码问题，而是环境没对齐——直接调对三件事就能跑通：工作目录、GO111MODULE开关、模块路径声明。

确保go test ./在项目根目录执行

GitHub Actions 默认在仓库根，但 Jenkins 或 GitLab Runner 常默认在 workspace 根，而非你的 go.mod 所在目录。一旦当前目录没有 go.mod，go test ./ 就会递归扫描到无关子目录，甚至加载错误的 module。

• 显式 cd $PROJECT_ROOT（Jenkins/GitLab CI 必加）；GitHub Actions 建议仍加 run: pwd && ls -la 确认当前目录有 go.mod
• 别用 go test .：只测当前包，漏子包
• 别用 go test ./:：会跨 module 扫描，可能触发 import path not found
• 坚持用 go test ./——前提是当前目录有 go.mod，且 module github.com/xxx/yyy 声明与所有 import 路径前缀一致

强制启用 Go Modules 模式

旧版 CI 环境可能残留 GOPATH 模式痕迹，go test 会退化为 GOPATH 查找逻辑，直接忽略 go.mod。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 显式设置 GO111MODULE=on：GitHub Actions 默认开启，但 Jenkins/GitLab CI 必须在 step 开头 export GO111MODULE=on
• 不要依赖 go env -w GO111MODULE=on：它写入用户级配置，在无状态 CI 容器中无效
• 验证是否生效：go env GO111MODULE 输出应为 on，不是 auto 或空

测试命令加 -v 和 -race 就够用

CI 不需要覆盖率或复杂报告，先保证核心逻辑不崩、并发不挂。过度配置只会拖慢流水线、掩盖真实问题。

• go test -v ./：显示每个测试名和失败详情，比默认输出更易定位
• go test -race -timeout 30s ./：开竞态检测，尤其对 sync、channel、全局变量敏感
• 避免 go test -coverprofile=coverage.out ./ 放在主流程：它显著拖慢执行，建议单独 job 或按需触发
• 别用 gotestsum 等第三方 runner：除非你真需要 HTML 报告或失败重试，否则纯原生命令更稳定、更少依赖

构建产物加 -ldflags="-s -w" 再上线

默认 go build 产物含完整符号表和 DWARF 信息，20MB+ 很常见，但其中 60%~70% 可安全移除——不影响 runtime.Caller 或 pprof，只删调试冗余。

• 必须加：go build -ldflags="-s -w" -o myapp ./cmd/api
• 慎用 -trimpath：它让 runtime.Caller 返回 clean 路径（如 main.go:12），但某些日志框架依赖绝对路径做 trace 关联
• 验证结果：file myapp 应显示 statically linked；ls -lh myapp 应 ≤ 12MB（禁用 CGO 时）

真正卡住 CI 的，从来不是语法或逻辑错误，而是 go.mod 在哪、GO111MODULE 是啥、当前目录有没有它——这三者对不齐，连 go list -m 都报错，更别说跑测试了。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！