使用Go Module构建项目

Golang 配置不是这里要讨论的新话题。但是在Go 1.12发布之后，我认为必须重新定义步骤，因为项目设置变得比以前简单明了。

在搜索配置步骤时，除了少数文章之外，大部分内容仍然是分享旧方式，即

设置GOPATH 环境变量
在GOPATH中创建项目以解析自定义包路径。
使用Go dep或其他外部工具（如glide）维护依赖性
依赖包会安装在同一工作区中。

通过本文，我们将看到项目设置及其发布如何在Go 1.12版本中进行。

在1.11版本中，Go引入了名为Go Modules的内置包管理，它正在开始进行重大改变Go生态系统。它是GOPATH的替代品，集成了版本控制和软件包分发支持。

在我们使用GOPATH的八年中，创建了大量的工具，假设Go源代码存储在GOPATH中。
迁移到Go模块将是Go生态系统中影响最深远的变化，因为Go 1.将整个生态系统 - 代码，用户，工具等 - 从GOPATH转换为模块将需要在许多不同领域开展工作。

由于1.12版本的Go模块默认启用，GOPATH将在1.13版本中弃用。

对于那些开始使用Go 1.12的人来说，安装和设置将如下所示。

安装Go

在Mac上

brew install go

在Ubuntu上

curl -O https://dl.google.com/go/go1.12.4.linux-amd64.tar.gz
tar -xvf go1.9.3.linux-amd64.tar.gz
sudo mv go /usr/local

*从Go 1.8开始，将GOPATH设置为环境变量不是必需的。如果我们没有设置一个，Go使用默认的GOPATH为 $HOME/go

构建项目

让我们在GOPATH之外的首选位置为go项目创建文件夹

注意： Go模块在GOPATH中被禁用。所以我们不能在GOPATH位置内部创建项目$HOME/go

mkdir goapp1
cd goapp1

初始化模块

使用Go模块初始化项目名称。

go mod init goapp1

这将创建模块配置文件go.mod，其中包含模块名称和版本。

此go.mod文件定义Module的根，go命令将相应地与包一起使用，作为GOPATH的替代。

使用模块

Go模块主要解决以下用例，

用于获取外部包的依赖关系管理。
解析自定义包作为GOPATH的替代。
包版本和发布

依赖管理

让我们使用jsoniter设置简单的json数据生成应用程序。

goapp.go

package main

import (
    "fmt"
    controllers "goapp1/handlers"

    jsoniter "github.com/json-iterator/go"
)

type AppInfo struct {
    Name string
}

func main() {
    info := AppInfo{
        Name: "GoApp",
    }
    jsonString, _ := jsoniter.Marshal(&info)

    fmt.Println(string(jsonString))

}

该go.mod配置的工作通常喜欢gemfile用Ruby，requirement.txtPython中或其他依赖管理工具，但不完全是。

构建go时，将根据go代码中的import语句获取最新版本的依赖项，并go.mod使用所需的依赖项更新配置。

go build

对于我们的示例，go build将获取最新的jsoniter及其依赖项。

每次go.mod得更新，go build命令创建一个名为的文件，go.sum其中包含特定模块版本内容的预期加密校验和。

go.sum不是锁文件。它仅用于验证目的。有关详细信息，请参阅这里 FAQ。

image.png

欲了解更多依赖管理使用情况参见这里。

解决自定义包

让我们创建一个自定义包并验证它是否在没有GOPATH的情况下得到解决。我创建了一个名为的包handlers

mkdir handlers

编写一个函数

package controllers

import "fmt"

func ShowInfo() {
    fmt.Println("controller modeule info")
}

使用main.go中的自定义包功能，

package main

import (
    "fmt"
    controllers "goapp1/handlers"

    jsoniter "github.com/json-iterator/go"
)

type AppInfo struct {
    Name string
}

func main() {
    info := AppInfo{
        Name: "GoApp",
    }
    jsonString, _ := jsoniter.Marshal(&info)

    fmt.Println(string(jsonString))
    controllers.ShowInfo()
}

现在go build解析没有GOPATH的自定义包。二进制文件将在指定的模块名称中创建go.mod 。

让我们执行结果。