go get仅管理依赖(下载源码、更新go.mod),不安装可执行文件;go install才是安装CLI工具的唯一方式,需带@version且不修改go.mod。

go get 不再是安装三方包的推荐方式,尤其不能用于安装可执行工具;现代 Go 项目(Go 1.11+)必须用 go mod 管理依赖,工具类需用 go install 带版本号安装。
go get 只负责拉取依赖,不装命令
很多人输 go get github.com/gin-gonic/gin 能用,但输 go get github.com/golangci/golangci-lint/cmd/golangci-lint 却提示 command not found——这不是 bug,是设计如此。go get 的作用仅限于:下载源码、更新 go.mod 和 go.sum、编译安装到 $GOPATH/pkg(供 import 使用)。它不会把二进制放到 $PATH 下。
- 只用于库依赖:比如
github.com/sirupsen/logrus、gopkg.in/yaml.v3 - 必须带模块路径:不能写
go get logrus,得写完整路径go get github.com/sirupsen/logrus@v1.9.3 - 不带
@version时,默认取最新 tag;若无 tag,则取 main 分支 HEAD,行为不可控,生产环境慎用 -
go get -u会升级间接依赖,可能引入 break change,别无脑跑
go install 才是装命令的唯一方式
从 Go 1.17 开始,go install 是安装 CLI 工具的**唯一标准方式**。它不修改当前项目的 go.mod,而是独立下载、编译、放进 $GOBIN(默认为 $GOPATH/bin)。
- 必须带
@version:例如go install github.com/cosmtrek/air@latest或go install golang.org/x/tools/cmd/goimports@v0.14.0 - 省略
@version会报错:invalid version: cannot find module providing package - 安装后检查是否生效:
which air(Linux/macOS)或where air(Windows) - 如果找不到命令,先确认
$GOBIN是否在$PATH中:echo $PATH | grep "$(go env GOBIN)"
go mod tidy 是清理依赖的底线操作
你删了 import "github.com/spf13/cobra",但 go.mod 里还留着 require?这是常见疏忽。Go 不会自动清理未使用的依赖,必须手动触发。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 每次增删
import后,运行go mod tidy—— 它会:移除未引用的require、补全缺失的间接依赖、同步更新go.sum -
go mod tidy不会自动升级版本,也不会拉新包,只做“最小必要修正” -
go.sum必须提交到 Git:它是构建可重现性的核心凭证,缺了它 CI 就可能因哈希不匹配失败 - 不要用
go mod vendor代替go mod tidy:vendor 是可选分发机制,tidy 是依赖状态校准必需步骤
国内用户绕不开的三个配置点
不是所有失败都叫“网络问题”,很多是代理、模块模式、路径三者没对齐。
立即学习“go语言免费学习笔记(深入)”;
- 确保模块启用:
go env GO111MODULE应输出on(Go 1.16+ 默认开启,旧版需手动设) - 设置国内代理:
go env -w GOPROXY=https://goproxy.cn,direct,direct表示私有模块走直连 - 验证 GOPATH/GOBIN 路径一致性:
go env GOPATH和go env GOBIN输出的路径,必须和你export PATH里加的一致;否则go install成功了也找不到命令
import 路径(如 github.com/go-sql-driver/mysql)和代码里用的包名(mysql)完全无关;而 go install 的路径(如 github.com/golangci/golangci-lint/cmd/golangci-lint)必须精确到 /cmd/xxx 这一级,少一个斜杠就失败。

















