go module

Go module

环境变量 GO111MODULE

GO111MODULE值	模式
off	<GOPATH mode>
on	<module-aware mode>
auto/空	<GOPATH mode>在 GOPATH/src 之内. <module-aware mode> 在 GOPATH/src 之外 而且 本目录或者父目录含有 go.mod.

module 模式

模式	描述
GOPATH mode	GOPATH 是依赖包的导入路径(含src和pkg). GOPATH/bin 是安装路径.
module-aware mode	GOPATH 不再是依赖包的导入路径. GOPATH/pkg/mod 才是依赖包的导入路径. GOPATH/bin 依然是安装路径.

注: GOBIN 的优先级高于 GOPATH/bin, 如果 GOBIN 被设置那么它就是安装路径.

module 组成

名称	描述
模块根目录 (module root)	包含 go.mod 的目录
模块 (module)	模块根目录下的所有 packages 的集合,但是不包含也是 module root 的子目录下的 packages.
模块路径(module path)	module root 的导入路径

go.mod 文件

• 模块声明
• 依赖模块和版本(require)
• 构建时依赖的模块的替代(replace)和排除的版本(exclude)

例子

    module example.com/m

    require (
        golang.org/x/text v0.3.0
        gopkg.in/yaml.v2 v2.1.0
    )

    exclude (
        golang.org/x/text v0.1.0
        golang.org/x/text v0.2.0
        golang.org/x/text v0.4.0
    )

    replace (
        golang.org/x/text v0.3.0 => github.com/golang/text v0.3.0
    )

模块的导入路径 example.com/m
依赖模块和版本 golang.org/x/text v0.3.0 , gopkg.in/yaml.v2 v2.1.0

新建 module

• 手动创建,在 module 的根目录添加 go.mod 文件,并加入 module 声明语句,如 module example.com/m.
• 自动创建,在 module 的根目录用 go mod init 命令,如 go mod init example.com/m.

go mod init 可以用于已经依靠 godep, glide, dep 管理的工程

go build,go test,go list 命令也会自动添加依赖(improts 的模块)到go.mod

参考

go help mod