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

1.1. 前言

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

  • Go语言官方安装文档
  • 如何写Go语言代码

1.2. 开发环境部署

1.2.1. 安装

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

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

package main

import "fmt"

func main() {
    fmt.Printf("hello, worldn")
}

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

> go build hello.go

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

> .hello.exe
hello, world

1.2.2. Go环境变量配置

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

> go env -w GOPATH=D:codeGo

设置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:codeGobin

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:codeGobin
> .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 

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

文章来源于互联网:Go开发环境部署与新手使用指南

发表评论