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 install、go build、go 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.Error 或 t.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
