gin项目jenkins ci/cd最常卡在go test ./报错、import path not found、二进制无法跨平台运行三处，根本原因是go模块路径、工作目录和构建环境未对齐：需显式cd项目根、设go111module=on、校验go.mod声明与import路径一致，并用cgo_enabled=0 goos=linux goarch=amd64构建可移植二进制。
直接说结论：Gin 项目跑 Jenkins CI/CD 流水线，最常卡在 go test ./ 报错、import path not found、二进制无法跨平台运行这三处。根本原因不是 Gin 本身，而是 Go 模块路径、工作目录和构建环境没对齐。
go test ./ 在 Jenkins 里总失败？先检查这三件事
本地能过，Jenkins 里报 cannot find package 或 import path not found，基本就是模块上下文崩了。
-
cd到项目根目录再执行测试：Jenkins 工作空间默认是 job 根，不是你 repo 的根；加一句cd $WORKSPACE或明确cd /var/lib/jenkins/workspace/your-job-name - 强制启用模块模式：
export GO111MODULE=on—— Jenkins 默认不设，GitHub Actions 才默认开启 - 别用
go test ./扫全目录：它会递归进 vendor、testdata、甚至子模块外的无关目录；改用go test ./...（三个点）或更安全的go test $(go list ./... | grep -v '/vendor\|/testdata') - 核对
go.mod第一行：module github.com/yourname/your-gin-project必须和代码里所有import路径完全一致，比如import "github.com/yourname/your-gin-project/router"
Jenkinsfile 里构建 Gin 二进制，CGO_ENABLED=0 不是可选项
Gin 本身纯 Go，但如果你用了 net/http 的某些底层特性（比如 TLS 系统证书链），或者后续引入了 cgo 依赖（如 SQLite、libgit2），没关 CGO 就会绑定宿主机 libc，导致部署到 Alpine 或其他发行版时 panic。
- 统一加
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o server . - 如果真要开 CGO（比如用 sqlite3），就得在 Jenkins slave 上装
gcc和对应 dev headers，并设CGO_ENABLED=1，但代价是镜像体积翻倍、部署环境强耦合 -
GOOS和GOARCH必须显式声明：Jenkins slave 可能是 ARM，而目标服务器是 x86_64，不指定就可能构建出跑不了的二进制
部署阶段 scp 失败？别信 Jenkins 内置的“Send files or execute commands over SSH”插件
这个插件在 Go 项目里经常静默失败：权限不对、路径不存在、密钥没加载、甚至因为 Jenkins 用户没配 ssh-agent 而卡住。
- 改用原生
scp+ssh命令组合，显式控制错误退出：scp -o ConnectTimeout=10 -o BatchMode=yes server user@prod-host:/opt/app/ && ssh user@prod-host 'chmod +x /opt/app/server' - 确保 Jenkins slave 的
~/.ssh/id_rsa已存在且权限是600；或者更推荐用sshpass配密码（仅限内网）：sshpass -p 'xxx' scp server user@prod-host:/opt/app/ - 上线前加健康检查：
ssh user@prod-host 'timeout 5s /opt/app/server -version 2>/dev/null || exit 1'，避免把挂掉的二进制直接切流量
真正难的不是写完 Jenkinsfile，而是每次换一台 slave、升级 Go 版本、或改一次 go.mod，都得重新校准模块路径、环境变量、SSH 权限这三根线——它们不报错，只悄悄让构建产物不可用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
