使用Go Module构建项目

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

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

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

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

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

来自Go博客

在我们使用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

让我们执行结果。

image.png

总结

模块系统将帮助我们为Go生态系统提供更好的身份验证和构建速度。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,607评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,047评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,496评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,405评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,400评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,479评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,883评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,535评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,743评论 1 295
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,544评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,612评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,309评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,881评论 3 306
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,891评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,136评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,783评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,316评论 2 342

推荐阅读更多精彩内容