Go语言go mod包依赖管理工具使用详解
首页
教程
VIP会员
一对一答疑
辅导班
公众号
首页
C语言教程
C++教程
Python教程
Java教程
Linux入门
更多>>
目录
Go语言
Go语言简介
Go语言基本语法
Go语言容器
流程控制
Go语言函数
Go语言结构体
Go语言接口
8 Go语言包（package） 8.1 包的基本概念8.2 Go语言封装简介及实现细节8.3 Go语言GOPATH8.4 Go语言常用内置包8.5 Go语言自定义包8.6 Go语言package8.7 Go语言导出包中的标识符8.8 Go语言import导入包8.9 Go语言工厂模式自动注册8.10 Go语言单例模式8.11 Go语言sync包与锁8.12 Go语言big包8.13 示例：使用图像包制作GIF动画8.14 Go语言正则表达式：regexp包8.15 Go语言time包：时间和日期8.16 Go语言os包用法简述8.17 Go语言flag包：命令行参数解析8.18 Go语言go mod包依赖管理工具8.19 示例：使用Go语言生成二维码8.20 Go语言Context（上下文）8.21 示例：客户信息管理系统8.22 示例：使用Go语言发送电子邮件8.23 Go语言（Pingo）插件化开发8.24 Go语言定时器实现原理及作用
Go语言并发
10
Go语言反射
11
Go语言文件处理
12
Go语言编译与工具
首页 > Go语言 > Go语言包（package）
Go语言go mod包依赖管理工具使用详解
最早的时候，Go语言所依赖的所有的第三方库都放在 GOPATH 这个目录下面，这就导致了同一个库只能保存一个版本的代码。如果不同的项目依赖同一个第三方的库的不同版本，应该怎么解决？
go module 是Go语言从 1.11 版本之后官方推出的版本管理工具，并且从 Go1.13 版本开始，go module 成为了Go语言默认的依赖管理工具。
Modules 官方定义为：
Modules 是相关 Go 包的集合，是源代码交换和版本控制的单元。Go语言命令直接支持使用 Modules，包括记录和解析对其他模块的依赖性，Modules 替换旧的基于 GOPATH 的方法，来指定使用哪些源文件。
如何使用 Modules？
1) 首先需要把 golang 升级到 1.11 版本以上（现在 1.13 已经发布了，建议使用 1.13）。
2) 设置 GO111MODULE。
GO111MODULE
在Go语言 1.12 版本之前，要启用 go module 工具首先要设置环境变量 GO111MODULE，不过在Go语言 1.13 及以后的版本则不再需要设置环境变量。通过 GO111MODULE 可以开启或关闭 go module 工具。
GO111MODULE=off 禁用 go module，编译时会从 GOPATH 和 vendor 文件夹中查找包；
GO111MODULE=on 启用 go module，编译时会忽略 GOPATH 和 vendor 文件夹，只根据 go.mod下载依赖；
GO111MODULE=auto（默认值），当项目在 GOPATH/src 目录之外，并且项目根目录有 go.mod 文件时，开启 go module。
Windows 下开启 GO111MODULE 的命令为：
set GO111MODULE=on 或者 set GO111MODULE=auto
MacOS 或者 Linux 下开启 GO111MODULE 的命令为：
export GO111MODULE=on 或者 export GO111MODULE=auto
在开启 GO111MODULE 之后就可以使用 go module 工具了，也就是说在以后的开发中就没有必要在 GOPATH 中创建项目了，并且还能够很好的管理项目依赖的第三方包信息。
常用的go mod命令如下表所示：
命令
作用
go mod download
下载依赖包到本地（默认为 GOPATH/pkg/mod 目录）
go mod edit
编辑 go.mod 文件
go mod graph
打印模块依赖图
go mod init
初始化当前文件夹，创建 go.mod 文件
go mod tidy
增加缺少的包，删除无用的包
go mod vendor
将依赖复制到 vendor 目录下
go mod verify
校验依赖
go mod why
解释为什么需要依赖
GOPROXY
proxy 顾名思义就是代理服务器的意思。大家都知道，国内的网络有防火墙的存在，这导致有些Go语言的第三方包我们无法直接通过go get命令获取。GOPROXY 是Go语言官方提供的一种通过中间代理商来为用户提供包下载服务的方式。要使用 GOPROXY 只需要设置环境变量 GOPROXY 即可。
目前公开的代理服务器的地址有：
goproxy.io；
goproxy.cn：（推荐）由国内的七牛云提供。
Windows 下设置 GOPROXY 的命令为：
go env -w GOPROXY=https://goproxy.cn,direct
MacOS 或 Linux 下设置 GOPROXY 的命令为：
export GOPROXY=https://goproxy.cn
Go语言在 1.13 版本之后 GOPROXY 默认值为 https://proxy.golang.org，在国内可能会存在下载慢或者无法访问的情况，所以十分建议大家将 GOPROXY 设置为国内的 goproxy.cn。
使用go get命令下载指定版本的依赖包
执行go get 命令，在下载依赖包的同时还可以指定依赖包的版本。
运行go get -u命令会将项目中的包升级到最新的次要版本或者修订版本；
运行go get -u=patch命令会将项目中的包升级到最新的修订版本；
运行go get [包名]@[版本号]命令会下载对应包的指定版本或者将对应包升级到指定的版本。
提示：go get [包名]@[版本号]命令中版本号可以是 x.y.z 的形式，例如 go get foo@v1.2.3，也可以是 git 上的分支或 tag，例如 go get foo@master，还可以是 git 提交时的哈希值，例如 go get foo@e3702bed2。
如何在项目中使用
【示例 1】创建一个新项目：
1) 在 GOPATH 目录之外新建一个目录，并使用go mod init初始化生成 go.mod 文件。
go mod init hello
go: creating new go.mod: module hello
go.mod 文件一旦创建后，它的内容将会被 go toolchain 全面掌控，go toolchain 会在各类命令执行时，比如go get、go build、go mod等修改和维护 go.mod 文件。
go.mod 提供了 module、require、replace 和 exclude 四个命令：
module 语句指定包的名字（路径）；
require 语句指定的依赖项模块；
replace 语句可以替换依赖项模块；
exclude 语句可以忽略依赖项模块。
初始化生成的 go.mod 文件如下所示：
module hello
go 1.13
2) 添加依赖。
新建一个 main.go 文件，写入以下代码：
package main
import (
"net/http"
"github.com/labstack/echo"
func main() {
e := echo.New()
e.GET("/", func(c echo.Context) error {
return c.String(http.StatusOK, "Hello, World!")
})
e.Logger.Fatal(e.Start(":1323"))
执行go run main.go运行代码会发现 go mod 会自动查找依赖自动下载：
go run main.go
go: finding github.com/labstack/echo v3.3.10+incompatible
go: downloading github.com/labstack/echo v3.3.10+incompatible
go: extracting github.com/labstack/echo v3.3.10+incompatible
go: finding github.com/labstack/gommon v0.3.0
......
go: finding golang.org/x/text v0.3.0
____ __
/ __/___/ / ___
/ _// __/ _ \/ _ \
/___/\__/_//_/\___/ v3.3.10-dev
High performance, minimalist Go web framework
https://echo.labstack.com
____________________________________O/_______
O\
⇨ http server started on [::]:1323
现在查看 go.mod 内容：
module hello
go 1.13
require (
github.com/labstack/echo v3.3.10+incompatible // indirect
github.com/labstack/gommon v0.3.0 // indirect
golang.org/x/crypto v0.0.0-20191206172530-e9b2fee46413 // indirect
go module 安装 package 的原则是先拉取最新的 release tag，若无 tag 则拉取最新的 commit，详见 Modules 官方介绍。
go 会自动生成一个 go.sum 文件来记录 dependency tree：
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/labstack/echo v3.3.10+incompatible h1:pGRcYk231ExFAyoAjAfD85kQzRJCRI8bbnE7CX5OEgg=
github.com/labstack/echo v3.3.10+incompatible/go.mod h1:0INS7j/VjnFxD4E2wkz67b8cVwCLbBmJyDaka6Cmk1s=
github.com/labstack/gommon v0.3.0 h1:JEeO0bvc78PKdyHxloTKiF8BD5iGrH8T6MSeGvSgob0=
github.com/labstack/gommon v0.3.0/go.mod h1:MULnywXg0yavhxWKc+lOruYdAhDwPK9wf0OL7NoOu+k=
github.com/mattn/go-colorable v0.1.2 h1:/bC9yWikZXAL9uJdulbSfyVNIR3n3trXl+v8+1sx8mU=
... 省略很多行
再次执行脚本go run main.go发现跳过了检查并安装依赖的步骤。
可以使用命令go list -m -u all来检查可以升级的 package，使用go get -u need-upgrade-package升级后会将新的依赖版本更新到 go.mod * 也可以使用go get -u升级所有依赖。
【示例 2】改造现有项目。
项目目录结构为：
├─ main.go
└─ api
└─ apis.go
main.go 源码为：
package main
import (
api "./api" // 这里使用的是相对路径
"github.com/labstack/echo"
func main() {
e := echo.New()
e.GET("/", api.HelloWorld)
e.Logger.Fatal(e.Start(":1323"))
api/apis.go 源码为：
package api
import (
"net/http"
"github.com/labstack/echo"
func HelloWorld(c echo.Context) error {
return c.JSON(http.StatusOK, "hello world")
1) 使用 go mod init *** 初始化 go.mod。
go mod init hello
go: creating new go.mod: module hello
2) 运行go run main.go。
go run main.go
go: finding golang.org/x/crypto latest
build _/D_/code/src/api: cannot find module for path _/D_/code/src/api
首先还是会查找并下载安装依赖，然后运行脚本 main.go，这里会抛出一个错误：
build _/D_/code/src/api: cannot find module for path _/D_/code/src/api
但是 go.mod 已经更新：
module hello
go 1.13
require (
github.com/labstack/echo v3.3.10+incompatible // indirect
github.com/labstack/gommon v0.3.0 // indirect
golang.org/x/crypto v0.0.0-20191206172530-e9b2fee46413 // indirect
那为什么会抛出这个错误呢？
这是因为 main.go 中使用 internal package 的方法跟以前已经不同了，由于 go.mod 会扫描同工作目录下所有 package 并且变更引入方法，必须将 hello 当成路径的前缀，也就是需要写成 import hello/api，以往 GOPATH/dep 模式允许的 import ./api 已经失效。
3) 更新旧的 package import 方式。
所以 main.go 需要改写成：
package main
import (
api "hello/api" // 这里使用的是相对路径
"github.com/labstack/echo"
func main() {
e := echo.New()
e.GET("/", api.HelloWorld)
e.Logger.Fatal(e.Start(":1323"))
提示：在 Go语言 1.11 版本下使用 go mod 时可能会遇到 go build github.com/valyala/fasttemplate: module requires go 1.12 这种错误，遇到类似这种需要升级到 1.12 的问题，直接升级到Go语言1.12 版本以上就好了。
4) 到这里就和新创建一个项目没什么区别了。
使用 replace 替换无法直接获取的 package
由于某些已知的原因，并不是所有的 package 都能成功下载，比如：golang.org 下的包。
modules 可以通过在 go.mod 文件中使用 replace 指令替换成 github 上对应的库，比如：
replace (
golang.org/x/crypto v0.0.0-20190313024323-a1f597ede03a => github.com/golang/crypto v0.0.0-20190313024323-a1f597ede03a
或者
replace golang.org/x/crypto v0.0.0-20190313024323-a1f597ede03a => github.com/golang/crypto v0.0.0-20190313024323-a1f597ede03a
关注公众号「站长严长生」，在手机上阅读所有教程，随时随地都能学习。本公众号由C语言中文网站长亲自运营，长期更新，坚持原创。
微信扫码关注公众号
优秀文章
信号量及其使用和实现(超详细)
C++ throw（抛出异常）详解
MySQL MAX函数：查询指定列的最大值
冒泡排序（起泡排序）算法及其C语言实现
C++ STL set删除数据：erase()和clear()方法
C++如何防止头文件被重复引入（3种方法）？
C++怎样查看输入流中的下一个字符？
GCC -E选项：对源程序做预处理操作
<fmt:parseNumber>标签
sklearn应用朴素贝叶斯算法
精美而实用的网站，分享优质编程教程，帮助有志青年。千锤百炼，只为大作；精益求精，处处斟酌；这种教程，看一眼就倾心。
关于网站 |
关于站长 |
如何完成一部教程 |
公众号 |
联系我们 |
网站地图
Copyright ©2012-2022 biancheng.net, 冀ICP备2022013920号, 冀公网安备13110202001352号
加入微信交流群，一起学习不枯燥。内含一款搜索神器，免费下载全网书籍和视频。