go install 用于安装第三方命令行工具(如 swag),需路径含 /cmd/xxx;go get 用于引入项目依赖库;注意 GOBIN 加入 PATH、版本兼容及权限问题。

安装 Golang 第三方库的构建工具,本质是安装一个可执行命令(比如 go install 安装的二进制),不是“装库”本身。关键在于区分:是想用某个工具(如 swag、mockgen、gofmt 的替代品 goformat 等),还是想为项目引入依赖库(如 github.com/gin-gonic/gin)。下面按常见需求说明。
用 go install 安装命令行工具(推荐方式)
Go 1.16+ 默认启用 GO111MODULE=on,直接用 go install 即可安装带 main 包的第三方工具:
- 确保
GOBIN已加入系统PATH(默认是$HOME/go/bin,Windows 是%USERPROFILE%\go\bin) - 运行命令,例如安装 Swagger 代码生成器:
go install github.com/swaggo/swag/cmd/swag@latest - 安装成功后,终端直接输入
swag version应能返回版本号 - 注意:路径末尾必须含
/cmd/xxx(表示这是可执行入口),且 Go 版本需 ≥ 工具要求的最低版本
旧版 Go 或需要指定 commit/tag 的情况
如果用的是 Go 1.15 或更早版本,或需锁定特定提交,可临时关闭模块模式或显式指定版本:
- 临时禁用模块(不推荐长期用):
GO111MODULE=off go get -u github.com/swaggo/swag/cmd/swag - 指定 tag(如 v1.8.10):
go install github.com/swaggo/swag/cmd/swag@v1.8.10 - 指定 commit hash:
go install github.com/swaggo/swag/cmd/swag@3a2b1c0
验证和排查常见问题
装完命令没反应?大概率是环境变量或权限问题:
立即学习“go语言免费学习笔记(深入)”;
- 运行
go env GOPATH和go env GOBIN,确认GOBIN路径存在且已加入PATH - 检查该路径下是否有对应二进制文件(如
swag或swag.exe) -
macOS / Linux 上可能需赋予执行权限:
chmod +x $GOBIN/swag - Windows 用户若提示“不是内部或外部命令”,请重启终端或重新加载环境变量
不需要安装——只是引入项目依赖库
如果目标是让项目代码能 import 第三方包(如 "github.com/go-sql-driver/mysql"),只需在项目根目录执行:
- go mod init your-project-name(首次初始化模块)
-
go get github.com/go-sql-driver/mysql(自动写入
go.mod并下载) - 之后在代码中
import即可使用,无需额外安装命令行工具
基本上就这些。核心记住:工具用 go install,库用 go get;路径、版本、环境变量三者对齐,基本不会出错。










