Go开发环境部署与新手使用指南

1. Go开发环境部署与新手使用指南

1.1. 前言

本篇blog基于Go语言官方文档给出的安装指南与代码编写指南整理而出,主要参考了以下几篇文章:


1.2. 开发环境部署

1.2.1. 安装

我准备在我的Windows 10系统中安装Go,所以,首先从Go官网下载Windows版安装程序

安装完毕后,编写个HelloWorld程序简单测试一下是否安装成功,新建文件hello.go,输入以下代码

package main

import "fmt"

func main() {
    fmt.Printf("hello, world\n")
}

然后,使用go命令编译该程序

> go build hello.go

执行在当前目录下编译出来的hello.exe程序,执行成功则表示Go语言安装成功

> .\hello.exe
hello, world

1.2.2. Go环境变量配置

设置GOPATH环境变量,该变量指向我们平时编写Go语言程序的常用工作路径

> go env -w GOPATH=D:\code\Go

设置GO111MODULE环境变量,打开GoMod功能,再配置七牛云提供的Go代理服务,让我们更顺利地下载Go的库

> go env -w GO111MODULE=on
> go env -w GOPROXY=https://goproxy.cn,direct

最后,设置GOBIN环境变量,我们使用go install的时候,会把编译出来的可执行程序都放到这里来

> go env -w GOBIN=D:\code\Go\bin

1.2.3. 配置VScode的Go语言插件支持

使用VScode打开刚才编写的hello.go文件,右下角会自动弹出安装Go相关插件的弹窗,点击Install即可安装

Go插件安装完毕后,再次打开hello.go,会弹窗提示我们安装go-outline等插件,大概有十多个,点击Install all来安装全部

如果没有配置GOPROXY环境变量来设置Go的代理,这里的插件大概率是无法安装成功的,由于我们在上一步已经设置了代理,所以这里应该会直接安装成功


1.3. 新手如何编写Go语言代码

在平时写代码时就考虑到包的组织结构,好像我们总有一天要发布代码一样,这是一个良好的习惯,Go语言官方文档也推荐我们这样做。接下来就通过简单的例子来了解一下如何用一种良好的习惯来写Go语言代码

1.3.1. 第一个程序

要编写并运行一个简单的程序,首先为模块选择一个路径(本例中选择example.com/user/hello),并创建一个go.mod来声明它

> mkdir hello
> cd hello
> go mod init example.com/user/hello
go: creating new go.mod: module example.com/user/hello
> cat go.mod
module example.com/user/hello

go 1.14

go源文件第一行必须是package name,可执行程序则必须使用package main,同一个目录下,只能有一个main

接下来,在当前目录中创建一个名为hello.go的文件,文件内容如下

package main

import "fmt"

func main() {
    fmt.Println("Hello, world.")
}

接下来,我们可以编译并安装该go程序了,执行以下命令

> go install example.com/user/hello

该命令会在我们之前设置的环境变量GOBIN指定目录下,生成二进制程序hello.exe

> cd D:\code\Go\bin
> .\hello.exe
Hello, world.

1.3.2. 从我的模块导入包

接下来,编写一个morestrings包并在hello程序中使用它。首先,在hello目录下新建一个文件夹morestrings,以及一个名为reverse.go的文件,文件内容如下

// Package morestrings implements additional functions to manipulate UTF-8
// encoded strings, beyond what is provided in the standard "strings" package.
package morestrings

// ReverseRunes returns its argument string reversed rune-wise left to right.
func ReverseRunes(s string) string {
    r := []rune(s)
    for i, j := 0, len(r)-1; i < len(r)/2; i, j = i+1, j-1 {
        r[i], r[j] = r[j], r[i]
    }
    return string(r)
}

reverse.go文件中,ReverseRunes首字母大写,表示该函数被导出,可以在其它导入了我们的morestrings包的程序中调用

接下载,修改hello.go的代码,在程序中调用刚才编写的包

package main

import (
    "fmt"

    "example.com/user/hello/morestrings"
)

func main() {
    fmt.Println(morestrings.ReverseRunes("Hello, world, reverse me."))
}

安装hello程序

> go install example.com/user/hello

运行该程序,可以看到如下输出

> .\hello.exe
.em esrever ,dlrow ,olleH

1.3.3. 从远程模块导入包

import包路径可以描述如何使用版本控制系统(例如Git或Mercurial)获取软件包源代码。 go工具使用此属性来自动从远程存储库获取软件包。这里,我们将要在程序中import github.com/google/go-cmp/cmp

package main

import (
    "fmt"

    "example.com/user/hello/morestrings"
    "github.com/google/go-cmp/cmp"
)

func main() {
    fmt.Println(morestrings.ReverseRunes("Hello, world, reverse me."))
    fmt.Println(cmp.Diff("Hello World", "Hello Go"))
}

当执行命令如go installgo buildgo run,go会自动下载远程模块,并在go.mod中记录其版本号

> go install example.com/user/hello
> .\hello.exe
.em esrever ,dlrow ,olleH
  string(
-       "Hello World",
+       "Hello Go",
  )

> cat go.mod
module example.com/user/hello

go 1.14

require github.com/google/go-cmp v0.5.0

1.3.4. 测试

go有一个由go test命令和testing包组成的轻量级测试框架

可以通过创建一个已 _test.go 结尾的测试文件,测试文件中包含函数名为 TestXXX 并且参数包含 func (t *testing.T) 。测试框架会为每一个这样的函数运行测试。如果函数调用了失败函数如 t.Errort.Fail ,测试会被认定为未通过/失败

让我们为morestrings包创建一个测试,在morestrings目录下新建测试文件reverse_test.go,包含如下代码

package morestrings

import "testing"

func TestReverseRunes(t *testing.T) {
    cases := []struct {
        in, want string
    }{
        {"Hello, world", "dlrow ,olleH"},
        {"Hello, 世界", "界世 ,olleH"},
        {"", ""},
    }
    for _, c := range cases {
        got := ReverseRunes(c.in)
        if got != c.want {
            t.Errorf("ReverseRunes(%q) == %q, want %q", c.in, got, c.want)
        }
    }
}

执行以下命令来运行自动化测试程序

> go test
PASS
ok      example.com/user/hello/morestrings      0.167s

1.4. 收工

写这篇文章的目的是最近在学习Go语言,新电脑也需要搭建Go相关环境,于是就整理了一下安装过程中的操作,以备日后使用。

同时也希望这篇文章能够带初学Go语言的朋友些许帮助,Thanks

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