本文介绍在 Jenkins 构建环境中解决 cannot find package "github.com/sparrc/go-ping" 错误的方法，核心是确保 Go 依赖在构建前被正确下载和安装。
本文介绍在 jenkins 构建环境中解决 `cannot find package "github.com/sparrc/go-ping"` 错误的方法，核心是确保 go 依赖在构建前被正确下载和安装。
在 Jenkins 中构建 Go 项目时，若代码中引用了外部模块（如 github.com/sparrc/go-ping），但构建失败并报错：
cannot find package "github.com/sparrc/go-ping" in any of:
/usr/local/go/src/github.com/sparrc/go-ping (from $GOROOT)
/var/lib/jenkins/go/src/github.com/sparrc/go-ping (from $GOPATH)这通常表明 Jenkins 构建节点未预装该依赖包。与本地开发环境不同，Jenkins 默认不会自动执行 go get，尤其在使用传统 GOPATH 模式（非 Go Modules）时更易出现此问题。
✅ 正确解决方案是在 go build 或 go test 前显式运行依赖获取命令：
go get -d -v github.com/sparrc/go-ping
-
-d表示仅下载依赖，不构建或安装； -
-v启用详细输出，便于排查网络或权限问题； - 推荐在 Jenkins 的 构建步骤 → 执行 shell 中添加该命令（置于
go build之前）。
⚠️ 注意事项：
- 确保 Jenkins Agent 的
GOPATH环境变量已正确定义（例如/var/lib/jenkins/go），且该路径具备写入权限； - 若使用 Go 1.11+ 且项目启用 Go Modules（即存在
go.mod文件），应优先使用go mod download替代go get，并在构建前确保GO111MODULE=on； - 对于企业级流水线，建议将依赖管理标准化：在
go.mod中声明依赖后，通过go mod tidy同步，并在 Jenkinsfile 中统一执行go mod download，提升可重现性与安全性。
? 补充提示：github.com/sparrc/go-ping 已归档（archived），官方推荐迁移到更活跃的替代库（如 github.com/prometheus-community/pro-bing）。新项目建议优先评估替代方案，以保障长期维护性与安全性。
