3 分钟摸清 $GOBIN 里的所有工具:gup list 与 check 查看版本实战

原创2026-11-13 14:49:412,292 阅读

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、pin、check 与 update 命令输出演示

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 命令演示:列出 $GOBIN 中所有 Go 工具的包路径与版本

几个实用细节:

  • 离线可用: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 工具,整个工具集的更新耗时约等于最慢那一个的构建时间:

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 分钟全部清楚。

登录后查看全文
gup