环境准备
这类小工具最怕的不是代码复杂,而是环境没配对。Go 版本、系统包、API 凭证,任何一项出错,最后都会体现在终端里的一条报错信息上。下面按 Ubuntu LTS 的常规装法来走,20.04、22.04、24.04 都适用。
先把系统包索引和已安装软件更新一下:
sudo apt update && sudo apt upgrade -y
apt update 只刷新软件源列表,不会真的安装东西;apt upgrade -y 才会把已装软件升级到新版本。这个步骤看起来普通,但能少碰不少依赖问题。
再装开发常用工具:
sudo apt install -y wget curl git build-essential
这里面最实用的是 wget、curl、git。build-essential 也别省,虽然 Go 本身不靠它编译,但项目里一旦碰到 CGO,就会用上 GCC 这套工具链。
安装 Go
我不太建议直接用 apt 装 Go。仓库里的版本经常落后,写 CLI 还好,真要用到新特性时会有点别扭。更省心的办法是直接下官方发行包。
先设一个版本变量:
GO_VERSION="1.23.6"
wget https://go.dev/dl/go${GO_VERSION}.linux-amd64.tar.gz
然后解压到 /usr/local,这是比较符合 Linux 习惯的放法:
sudo tar -C /usr/local -xzf go${GO_VERSION}.linux-amd64.tar.gz
rm go${GO_VERSION}.linux-amd64.tar.gz
tar 的几个参数不用背太多,常用的就是 -C 指定目标目录,-x 解包,-z 处理 gzip,-f 指定文件名。
接着把 Go 加到 PATH,顺手把 GOPATH 也配上:
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
echo 'export GOPATH=$HOME/go' >> ~/.bashrc
echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bashrc
改完执行:
source ~/.bashrc
go version
能看到版本号,说明这一步就算过了。
接入云端大模型
这个客户端本质上只是一个薄壳:本地负责输入输出,真正的推理由云端模型完成。这里用的是兼容 OpenAI 风格的 HTTP 接口,接入方式比较直接。
你需要准备两样东西:API Key 和模型地址。示例里用了 ,端点是:


