Go mod：一文教你真正用起来Go Module依赖管理
Golang环境变量
GOROOT：go的安装路径
在
~/.bash_profile中添加下面语句配置GOROOT环境变量GOROOT=/usr/local/go export GOROOT要执行go命令和go工具, 就要配置go的可执行文件的路径:
export $PATH:$GOROOT/bin注：$PATH windows用
;符号分割, mac和类unix用:符号分割GOPATH: go的工作路径
可以在自己的用户目录下面创建一个目录, 如gopath
cd ~ mkdir gopath在
~/.bash_profile中添加如下语句:export GOPATH=/Users/username/gopath不要把
GOPATH设置成go的安装路径,GOPATH下主要包含三个目录：binpkgsrcsrc: 存放源代码（比如：.go .c .h .s等）
pkg: 编译后生成的文件（比如：.a）
bin: 编译后生成的可执行文件, 为了方便，可以把此目录加入到
$PATH变量中，如果有多个gopath，那么使用${GOPATH//://bin:}/bin添加所有的bin目录
注： Go 1.8 版本之前，GOPATH 环境变量默认是空的；1.8版本之后，默认路径是：
$HOME/go
Go Modules
go modules是 golang 1.11引入的新特性。模块是相关Go包的集合。modules是源代码交换和版本控制的单元。 go命令直接支持使用modules，包括记录和解析对其他模块的依赖性。modules替换旧的基于GOPATH的方法来指定在给定构建中使用哪些源文件。
GO111MODULE有三个值：off、on 和 auto(默认值)
GO111MODULE=off，无模块支持，go 会从 GOPATH 和 vendor 文件夹寻找包GO111MODULE=on，模块支持，go 会忽略 GOPATH 和 vendor 文件夹，只根据go.mod下载依赖GO111MODULE=auto，在$GOPATH/src外面且根目录有go.mod文件时，开启模块支持
在使用模块的时候，
GOPATH是无意义的，不过它还是会把下载的依赖储存在$GOPATH/src/mod中，也会把go install的结果放在$GOPATH/bin中。GOPROXY
由于中国政府的网络监管系统，Go 生态系统中有着许多中国 Gopher 们无法获取的模块，比如最著名的
golang.org/x/...。并且在中国大陆从 GitHub 获取模块的速度也有点慢。因此需要配置GOPROXY来加速Module依赖下载，这里使用goproxy.cn代理，详细介绍：传送门Go 1.13及以上版本
go env -w GOPROXY=https://goproxy.cn,directGo 1.13以下的版本
export GOPROXY=https://goproxy.cn
注: 推荐将 GO111MODULE 设置为on 而不是auto
Go mod
Golang 1.11 版本引入的 go mod ，其思想类似maven：摒弃vendor和GOPATH，拥抱本地库。从 Go 1.11 开始，Go 允许在 $GOPATH/src 外的任何目录下使用 go.mod 创建项目。在$GOPATH/src中，为了兼容性，Go 命令仍然在旧的 GOPATH 模式下运行。从 Go 1.13 开始，Module模式将成为默认模式。
go mod 命令
go mod The commands are:download download modules to local cache (下载依赖的module到本地cache))edit edit go.mod from tools or scripts (编辑go.mod文件)graph print module requirement graph (打印模块依赖图))init initialize new module in current directory (再当前文件夹下初始化一个新的module, 创建go.mod文件))tidy add missing and remove unused modules (增加丢失的module，去掉未用的module)vendor make vendored copy of dependencies (将依赖复制到vendor下)verify verify dependencies have expected content (校验依赖)why explain why packages or modules are needed (解释为什么需要依赖)新项目
你可以在
GOPATH之外创建新的项目。go mod init packagename可以创建一个空的go.mod,然后你可以在其中增加require github.com/smallnest/rpcx latest依赖，或者像上面一样让go自动发现和维护。go mod download可以下载所需要的依赖，但是依赖并不是下载到$GOPATH中，而是$GOPATH/pkg/mod中，多个项目可以共享缓存的module。老项目
假设你已经有了一个go 项目， 比如在
$GOPATH/github.com/smallnest/rpcx下， 你可以使用go mod init github.com/smallnest/rpcx在这个文件夹下创建一个空的go.mod(只有第一行module github.com/smallnest/rpcx)。然后你可以通过
go get ./...让它查找依赖，并记录在go.mod文件中(你还可以指定-tags,这样可以把tags的依赖都查找到)。通过
go mod tidy也可以用来为go.mod增加丢失的依赖，删除不需要的依赖，但是我不确定它怎么处理tags。执行上面的命令会把
go.mod的latest版本换成实际的最新的版本，并且会生成一个go.sum记录每个依赖库的版本和哈希值。
实战
示例一：创建一个新项目
在
GOPATH 目录之外新建一个目录，并使用go mod init初始化生成go.mod文件
➜ ~ mkdir hello
➜ ~ cd hello
➜ hello go mod init hello
go: creating new go.mod: module hello
➜ hello ls
go.mod
➜ hello cat go.mod
module hellogo 1.12
go.mod文件一旦创建后，它的内容将会被go toolchain全面掌控。go toolchain会在各类命令执行时，比如go get、go build、go mod等修改和维护go.mod文件。
go.mod 提供了module, require、replace和exclude 四个命令
module语句指定包的名字（路径）require语句指定的依赖项模块replace语句可以替换依赖项模块exclude语句可以忽略依赖项模块
添加依赖
新建一个 server.go 文件，写入以下代码：
package mainimport ("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 server.go 运行代码会发现 go mod 会自动查找依赖自动下载：
$ go run server.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/color latest
go: finding github.com/labstack/gommon/log latest
go: finding github.com/labstack/gommon v0.2.8
# 此处省略很多行
...____ __/ __/___/ / ___/ _// __/ _ \/ _ \
/___/\__/_//_/\___/ v3.3.10-dev
High performance, minimalist Go web framework
https://echo.labstack.com
____________________________________O/_______O\
⇨ http server started on [::]:1323
现在查看go.mod 内容：
$ cat go.modmodule hellogo 1.12require (github.com/labstack/echo v3.3.10+incompatible // indirectgithub.com/labstack/gommon v0.2.8 // indirectgithub.com/mattn/go-colorable v0.1.1 // indirectgithub.com/mattn/go-isatty v0.0.7 // indirectgithub.com/valyala/fasttemplate v1.0.0 // indirectgolang.org/x/crypto v0.0.0-20190313024323-a1f597ede03a // indirect
)
go module 安装 package 的原則是先拉最新的 release tag，若无tag则拉最新的commit。 go 会自动生成一个 go.sum 文件来记录 dependency tree：
$ cat go.sum
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.2.8 h1:JvRqmeZcfrHC5u6uVleB4NxxNbzx6gpbJiQknDbKQu0=
github.com/labstack/gommon v0.2.8/go.mod h1:/tj9csK2iPSBvn+3NLM9e52usepMtrd5ilFYA+wQNJ4=
github.com/mattn/go-colorable v0.1.1 h1:G1f5SKeVxmagw/IyvzvtZE4Gybcc4Tr1tf7I8z0XgOg=
github.com/mattn/go-colorable v0.1.1/go.mod h1:FuOcm+DKB9mbwrcAfNl7/TZVBZ6rcnceauSikq3lYCQ=
... 省略很多行
再次执行脚本
go run server.go发现跳过了检查并安装依赖的步骤。可以使用命令
go list -m -u all来检查可以升级的package，使用go get -u need-upgrade-package升级后会将新的依赖版本更新到go.mod * 也可以使用go get -u升级所有依赖
go get 升级
运行 go get -u 将会升级到最新的次要版本或者修订版本(x.y.z, z是修订版本号， y是次要版本号)
运行 go get -u=patch 将会升级到最新的修订版本
运行 go get package@version 将会升级到指定的版本号version
运行go get如果有版本的更改，那么go.mod文件也会更改
示例二：改造现有项目(helloword)
项目目录为：
$ tree
.
├── api
│ └── apis.go
└── server.go1 directory, 2 files
server.go 源码为：
package mainimport (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 apiimport ("net/http""github.com/labstack/echo"
)func HelloWorld(c echo.Context) error {return c.JSON(http.StatusOK, "hello world")
}
export GO111MODULE=on 先设置环境变量开启Module功能
使用
go mod init ***初始化go.mod
$ go mod init helloworld
go: creating new go.mod: module helloworld
运行
go run server.go
go: finding github.com/labstack/gommon/color latest
go: finding github.com/labstack/gommon/log latest
go: finding golang.org/x/crypto/acme/autocert latest
go: finding golang.org/x/crypto/acme latest
go: finding golang.org/x/crypto latest
build command-line-arguments: cannot find module for path _/home/gs/helloworld/api
首先还是会查找并下载安装依赖，然后运行脚本 server.go，这里会抛出一个错误：
build command-line-arguments: cannot find module for path _/home/gs/helloworld/api
但是go.mod 已经更新：
$ cat go.mod
module helloworldgo 1.12require (github.com/labstack/echo v3.3.10+incompatible // indirectgithub.com/labstack/gommon v0.2.8 // indirectgithub.com/mattn/go-colorable v0.1.1 // indirectgithub.com/mattn/go-isatty v0.0.7 // indirectgithub.com/valyala/fasttemplate v1.0.0 // indirectgolang.org/x/crypto v0.0.0-20190313024323-a1f597ede03a // indirect
)
那为什么会抛出这个错误呢？
这是因为 server.go 中使用 internal package 的方法跟以前已经不同了，由于 go.mod会扫描同工作目录下所有 package 并且变更引入方法，必须将 helloworld当成路径的前缀，也就是需要写成 import helloworld/api，以往 GOPATH/dep 模式允许的 import ./api 已经失效，详情可以查看这个 issue。
更新旧的package import 方式
所以server.go 需要改写成：
package mainimport (api "helloworld/api" // 这是更新后的引入方法"github.com/labstack/echo"
)func main() {e := echo.New()e.GET("/", api.HelloWorld)e.Logger.Fatal(e.Start(":1323"))
}
一个小坑：开始在golang1.11 下使用go mod 遇到过go build github.com/valyala/fasttemplate: module requires go 1.12这种错误，遇到类似这种需要升级到1.12 的问题，直接升级golang1.12 就好了。幸亏是在1.12 发布后才尝试的go modGo mod：一文教你真正用起来Go Module依赖管理相关推荐
- go build不从本地gopath获取_跟我一起学习go语言，包依赖管理工具go mod
Go Module是Go会在1.12中正式推出的包管理机制. Go mod 简介 Golang一直存在一个被人诟病的问题是缺少一个官方的包依赖管理工具.从我个人的角度上来看存在两个问题: GOPATH ...
- Go mod 依赖管理
1 go mod Go.mod是Golang1.11版本新引入的官方包管理工具,用于解决记录依赖包具体版本的问题,方便依赖管理,类似于(composer.json 和composer.lock文件) ...
- go mod依赖离线安装_Go语言go mod包依赖管理工具使用详解
go modules 是 golang 1.11 新加的特性.现在 1.12 已经发布了,是时候用起来了.Modules 官方定义为: 模块是相关 Go 包的集合.modules 是源代码交换和版本控 ...
- golang---go mod 相关问题的解决方法（Unexpected module path、used for two different module）
做这一切的前提: 首先配置goproxy中国proxy 直接上图: 正如图中所示:当出现这种问题时: 我们需要将里面的包替换,可能由于版本原因,或者修改了包的位置,所以需要修改包的来源,replace ...
- 官方教程：Go fuzzing模糊测试
前言 Go 1.18在go工具链里引入了fuzzing模糊测试,可以帮助我们发现Go代码里的漏洞或者可能导致程序崩溃的输入.Go官方团队也在官网发布了fuzzing入门教程,帮助大家快速上手. 本人对 ...
- go build不从本地gopath获取_Go包管理GOPATH、vendor、go mod机制
简介 Golang 作为开源编程语言,在 2012 年编程语言 Go 1 发布之后,一直在不断发展,并伴随着云原生而广泛进入各大公司. 在互联网发展至今,软件系统不断膨胀. 各个编程语言也都逐步支持了 ...
- golang mod 包管理使用 引入本地包
对于多个项目来说,把所有的源码都放在GOPATH下的src目录下非常的不方便.golang给我们提供了一个叫go mod的命令来脱离src目录,方便我们管理go项目. 对于windows用户来说,使用 ...
- go mod 相关的八个命令
该go mod命令用于对模块执行操作.八个go mod命令是: 命令 手术 用法 download 将模块下载到本地缓存(GOPATH/pkg/mod/cache).可以使用查询请求特定的模块版本pa ...
- go mod常用命令
指定module的根目录并生成go.mod文件 go mod init example.com/hello 下载并添加依赖到go.mod文件中 go build, go test 查看module下的 ...
最新文章
- 无数优秀投资人的选择——GMQ Group
- UI常见测试用例-51testing
- svc android,在android中，如何使用 Svc WCF服务_android_开发99编程知识库
- 云计算基础介绍，比喻小理解！
- 娱美德投入千万研发 揭秘韩国第一游戏引擎
- linux 定时切割日志,Linux 定时切割日志任务
- 如何理解苹果iOS版PhoneGap原理分析
- 什么是单页应用(转)
- FPGA 常用AXI总线介绍
- 微软将不再把 .NET Framework API 移植到 .NET Core 3.0
- 从rpm包中提取文件的命令
- 【编译工具】之Andorid pthread_cancel函数
- cpu频率_CPU频率被锁定到800mhz怎么办?
- Ecshop去版权方法？如何去除Ecshop版权？
- 蓝色创意酒店装饰设计织梦自适应模板
- Android10.0编译 make api-stubs-docs-update-current-api问题
- Linux Centos 7移动电信双线 策略路由
- win10计算机入门使用教程,win10技巧大全_win10使用技巧方法教程 - 系统家园
- 2021年Robocom 复赛题解
- python win32gui模块详解_Python笔记_第二篇_面向过程_第二部分_4.常用模块的简单使用_窗体控制模块(win32con、win32gui)...
热门文章
- 宏观经济学-试卷1-安徽大学
- 【按键精灵篇】如何做一个自动打开APP进入注册页面自动输入自己手机号
- SpringSecurity OAuth2.0认证授权-part1
- Step1：模型 16个相机参数（内参、外参、畸变参数）
- 富文本编辑器 CKeditor 配置使用+上传图片
- OCR文档识别——数据录入工厂
- 手撸一个RPC框架——傻瓜式教程（一）
- PC/SC标准读卡器，SCardConnect返回6处理，PCSC API函数写法
- C++57个入门知识点_17 类的访问权限及C语言模拟类的封装（类的私有权限突破方法：编译期进行权限检查，运行期通过指针修改类的私有成员变量；利用函数指针对结构体中成员变量进行修改；CPU大小尾排列）
- three.js 光的介绍（05）