Golang第三方工具安装教程

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 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；路径、版本、环境变量三者对齐，基本不会出错。