3 分钟摸清 $GOBIN 里的所有工具:gup list 与 check 查看版本实战
3 分钟摸清 $GOBIN 里的所有工具:gup list 与 check 查看版本实战
gup 是一个管理 $GOBIN 中 Go 命令行工具(go-binaries)的快速管理器。用 gup list 一行命令列出所有已安装工具的包路径和版本,用 gup check 快速检查哪些工具不是最新版本。本文带你 3 分钟摸清家底,看懂输出、掌握常用参数。
为什么你需要给 $GOBIN 做一次"体检"
用 go install 安装工具时,二进制会被放进 $GOBIN(通常是 $GOPATH/bin),但 go 命令装完就"忘了":它不记录装过什么、不跟踪版本、更不会主动更新。时间一长,$GOBIN 里会堆满来路不明的旧版本工具。
gup 读取每个二进制里烧录的构建信息(import path、版本、Go 工具链版本),把已有的工具集当成清单来管理。gup list 和 gup check 正是两个最基础的"查看版本"命令:一个回答"我装了哪些工具、各是什么版本",另一个回答"哪些工具该更新了"。
gup list:30 秒列出全部工具与版本
安装 gup 后(go install github.com/nao1215/gup@latest),直接运行:
$ gup list
gal: github.com/nao1215/gal/cmd/gal@v1.1.1
posixer: github.com/nao1215/posixer@v0.1.0
subaru: github.com/nao1215/subaru@v1.0.0
输出共三要素,一目了然:
- 工具名(
gal):在$GOBIN下的二进制文件名,左对齐排列 - import path:
go install时使用的包路径,是将来重装、迁移的依据 - 版本(绿色高亮):该二进制编译时对应的模块版本
几个实用细节:
- 离线可用:
gup list只读取本地构建信息,不联网、不要求go命令在 PATH 中(实现见 cmd/list.go) - JSON 输出:加
--json可得到机器可读的数组,配合jq提取字段,例如gup list --json | jq -r '.[].name'只拿工具名 - 非 go install 安装的二进制:会被如实报告,而不是被悄悄隐藏
- $GOBIN 为空:首次使用时看到空环境提示属于正常情况,不是报错
gup check:哪些工具需要更新
gup check 逐个把工具与其模块的最新版本、以及当前 Go 工具链做比对,只报告、不安装任何东西:
$ gup check
check binary under $GOPATH/bin or $GOBIN
[ 1/33] github.com/cheat/cheat (Already up-to-date: v0.0.0-20211009161301-12ffa4cb5c87 / go1.22.4)
[ 2/33] fyne.io/fyne/v2 (current: v2.1.3, latest: v2.1.4 / current: go1.20.2, installed: go1.22.4)
[33/33] github.com/nao1215/ubume (Already up-to-date: v1.5.0 / go1.22.4)
If you want to update binaries, the following command.
$ gup update fyne_demo gup mimixbox
读懂两行输出即可:
Already up-to-date:版本与 Go 工具链都是最新的,无需处理current: vX, latest: vY:有新版本;current: goX, installed: goY则提示该工具是用旧版 Go 编译的
结尾会自动给出"下一步命令"——把待更新的工具名拼好的 gup update 语句,复制执行即可,省去手敲。
常用参数速查
| 参数 | 作用 |
|---|---|
gup check lazygit mimixbox |
只检查指定的几个工具,不做全量扫描 |
--quiet(-q) |
隐藏"已是最新"的行,只列出待更新项和一行汇总,工具多时特别清爽 |
--ignore-go-update |
只比模块版本,忽略 Go 工具链差异 |
--jobs(-j) |
指定并行检查的 worker 数,默认等于 CPU 核心数 |
--json |
输出 JSON 数组,适合写脚本或接入 CI |
一个对脚本友好的细节:check 发现待更新项时退出码仍是 0("找到旧版本"是它的本职,不是失败);只有用法错误、配置错误或某个包检查失败才返回 1。因此可以放心地把它放进定时任务里做巡检。
check 之后的下一步:gup update
gup check 是只读体检,真正动手更新交给 gup update。它会并行重装全部 $GOBIN 工具,整个工具集的更新耗时约等于最慢那一个的构建时间:
如果只想先看看会发生什么,加 --dry-run 预览;想跳过个别工具用 --exclude=gopls,golangci-lint。
常见坑位与排错
- 命令变成 git 操作? oh-my-zsh 内置了一个名为
gup的别名(git pull --rebase),会遮蔽 gup 命令。重命名该别名,或用反斜杠绕过:\gup update - 误删工具?
remove删除前会逐个确认,且gup list不会把 gup 的锁文件.gup.lock当成工具列出来 - 项目文档:更多场景化的"一行流"配方见 doc/cookbook.md,全部子命令与 JSON 字段说明见 website/content/reference.md
- 想看实现:list 与 check 命令的源码分别在 cmd/list.go 和 cmd/check.go
总结
gup list:离线、秒出,给出$GOBIN中每个工具的 名字 + 包路径 + 版本gup check:并行比对最新版本与 Go 工具链,只报告不安装,并自动附赠下一步gup update命令- 加上
--json、--quiet等参数,这两个命令可以直接纳入脚本和 CI 做定期巡检
跑完这一遍,你的 $GOBIN 里有什么、谁该更新,3 分钟全部清楚。


