go test ./ 在ci中失败主因是工作目录与模块路径不匹配，需显式cd项目根、设go111module=on、避免./...扫描无关目录，并确保go.mod声明与导入路径一致。
go test ./ 为什么在CI里总失败？
因为本地能过，CI里常报 import path not found 或 cannot find package —— 根本原因是没设好模块路径和工作目录。CI环境不会自动识别你的项目根，go test ./ 会从当前目录递归扫描，但若 go.mod 不在工作目录下，或 GOPATH 干扰残留（尤其旧 Jenkins），就会找不到包。
- 确保 CI 步骤第一行是
cd $PROJECT_ROOT（或用actions/checkout@v4后默认在 repo 根） - 强制使用模块模式：
export GO111MODULE=on（GitHub Actions 默认开启，Jenkins/GitLab CI 需显式设置） - 避免用
go test ./...：它会扫子模块外的无关目录，可能触发错误 import；改用go test ./...仅当明确需跨 module 测试，否则坚持go test ./... - 检查
go.mod里module声明是否与实际导入路径一致（例如module github.com/org/service-a），否则go test会拒绝加载内部包
如何让 go build 产出最小可用二进制？
微服务镜像大小直接拖慢部署速度，而 Go 默认编译产物含调试符号、反射信息，动辄 20MB+。关键不是“能不能删”，而是“删掉后会不会影响 panic 堆栈或 pprof 分析”——答案是：可以安全裁剪，只要保留必要符号。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 必须加的链接参数：
-ldflags="-s -w"，其中-s去除符号表，-w去除 DWARF 调试信息；两者合用可减掉 60%~70% 体积 - 慎用
-trimpath：它抹掉源码绝对路径，让runtime.Caller返回 clean 路径，但某些日志框架依赖完整路径做 trace，建议只在 release 镜像启用 - 多阶段 Dockerfile 中，build 阶段用 full golang:1.22 镜像，final 阶段用
scratch或gcr.io/distroless/static:nonroot，只 COPY 二进制，不带任何 SDK 或 shell - 验证是否成功：运行
file myservice应显示 “statically linked”，ls -lh myservice应 ≤ 12MB（无 CGO 时）
golangci-lint 在流水线里该跑哪些检查？
开全量 linter 会让 CI 变慢且误报多，尤其 gosimple 和 staticcheck 对泛型代码支持不稳定。微服务场景下，应聚焦阻断型问题，而非风格争议。
- 必启项：
govet（标准库静态分析）、errcheck（忽略 error 的典型隐患）、ineffassign（无用赋值）、nilness（空指针静态推断） - 建议关闭：
golint（已废弃）、stylecheck（过度约束命名）、dupl（重复代码检测易误伤模板生成代码） - 配置文件里加
run.timeout: 3m，防止大项目卡死；CI 步骤中加--fast参数跳过耗时检查（如goconst） - 错误级别设为
severity: error，让 CI 直接失败，而不是只 warning —— 微服务间调用链脆弱，一个未处理 error 可能引发雪崩
为什么 Jenkins Pipeline 里 go mod download 总超时？
不是网络差，是默认没配代理或 GOPROXY。国内公有云 CI 环境（尤其腾讯云、阿里云）直连 proxy.golang.org 几乎必然失败，且 go mod download 默认不重试，一次超时就中断整个流水线。
- 必须在 pipeline 开头设置：
env.GOPROXY = "https://goproxy.cn,direct"（CN 域名稳定，direct 保底 fallback） - Jenkinsfile 中避免写死
go mod download，改用go mod tidy -v：它隐式触发 download，且自带重试逻辑，失败时会打印缺失模块名，便于定位 - 若用私有模块（如公司 Nexus），追加
env.GOPRIVATE = "git.internal.company.com/*"，否则 go 会拒绝对其走 proxy - 缓存
/go/pkg/mod目录（Jenkins agent 挂载 hostPath 或 PVC），否则每次新建 pod 都重新下载，10 个微服务并发构建时 IO 成瓶颈
GOOS、CGO_ENABLED、GOPROXY 的默认值差异，以及 Jenkins agent 宿主机上残留的 $HOME/go 路径污染 —— 这些细节不显式覆盖，流水线就永远在“本地 OK，CI 报错”的循环里打转。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
