jenkins pipeline 中调用 go 代码需显式声明 tool 'go-1.21'、绝对路径执行、禁用 cgo（cgo_enabled=0）、输出到 ${workspace}/bin、参数用数组式传参、敏感值走环境变量、归档产物、共享库修改后需手动重载配置。
Go 代码怎么在 Jenkins Pipeline 里调用
不能直接执行 go run 脚本就完事——Jenkins Pipeline 运行在 Groovy 沙箱里，没 Go 环境、没 GOPATH、也没模块缓存。必须显式声明 Go 工具链，且所有依赖得提前拉齐。
- 在
Jenkinsfile中用tool 'go-1.21'声明已配置的 Go 版本（不是sh 'go version'那种裸命令） - 共享库里的 Go 工具类（比如封装了
go test或go build）必须通过sh步骤调用，且路径要绝对：先cd ${WORKSPACE}再执行，否则go mod download会失败 - 若共享库本身含 Go 代码（如
vars/goUtils.groovy），它只能调用 shell 命令，不能 import 或编译 Go 包——Groovy 和 Go 是隔离的
共享库中如何安全传参给 Go 二进制
Go 编译出的二进制常需接收参数（如 --env=prod、--timeout=30s），但 Jenkins Pipeline 的字符串拼接容易被空格或特殊字符截断，导致命令解析失败。
- 避免拼接：
sh "mytool --name ${params.NAME} --env ${params.ENV}"→ 若params.NAME含空格，直接报错mytool: command not found - 改用数组式调用：
sh(script: "mytool \${ARGS}", args: ["--name", params.NAME, "--env", params.ENV])，再在脚本里用"\$@"透传 - 敏感值（如 token、密码）别塞进命令行——会被
ps看见；改用环境变量：withEnv(["MY_TOKEN=${params.TOKEN}"]) { sh 'mytool --auth-env' }
为什么 go build -o /tmp/mytool 在 Pipeline 里总失败
不是权限问题，也不是路径不存在，而是 Jenkins agent 的 workspace 默认不可写入 /tmp（尤其在容器化 agent 中），且跨 stage 的临时文件无法保证存在。
-
/tmp在大多数 Kubernetes agent 中是内存盘，重启即丢；应统一输出到${WORKSPACE}/bin/ - 如果 Go 项目用了 cgo，
CGO_ENABLED=0必须显式设，否则容器 agent 里缺 gcc 会静默失败（只报exit status 2） - 构建产物要归档：用
archiveArtifacts artifacts: 'bin/**'，否则下一个 stage 找不到mytool
共享库升级后 Pipeline 报 No such property: goUtils for class
这不是语法错误，是 Jenkins 共享库加载机制导致的缓存错位：Global Library 的变更不会自动刷新到正在运行的 Pipeline，旧版本还在内存里。
立即学习“go语言免费学习笔记（深入）”；
- 修改
vars/goUtils.groovy后，必须去 Jenkins 管理界面点 “Reload configuration from SCM” - 若用的是分支策略（如
mastervsmain），确认 Pipeline 中@Library('my-lib') _引用的分支和你 push 的一致 - 本地调试时，
load本地脚本绕过共享库缓存，但上线后失效——别依赖load 'src/goUtils.groovy'做长期方案
真正麻烦的是 Go 模块校验和与 Jenkins agent 的 GOPROXY 不一致，导致同一 commit 下 go build 结果不同——这问题不会报错，只会让 binary 行为飘移，得盯紧 go.sum 和 agent 的 ~/.netrc 配置。
