服务计算实验：安装 golang 开发环境

服务计算实验：安装 golang 开发环境

课程实验作业源博客：安装 go 语言开发环境

实验环境：CentOS 7

安装 VS code 编辑器

如果你是 vim 或 emacs 用户，可以忽略本段内容。

$ sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
$ sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'
$ yum check-update
$ sudo yum install code

安装完成后，在终端键入 code

即可运行 VS code 编辑器。

若需要添加桌面图标，点击 CentOS 桌面左上方应用程序，找到编程，鼠标左键选中 VS code 并拖到桌面上即可。

安装 golang

建议使用系统包管理工具安装，即使不是最新版本，也不影响正常使用。

$ sudo yum install golang

查看安装目录

$ rpm -ql golang |more

测试安装

$ go version

以上内容参考本次作业源博客，后续内容则参考GO官方教程

GOPATH 环境变量

我们在上一步已经完成了 golang 的安装，现在我们来配置开发Go代码时需要设置的环境变量——GOPATH。

首先创建一个工作空间目录，并设置相应的 GOPATH。你的工作空间可以放在任何地方， 但它绝对不能和你的Go安装目录相同。（在这里我设置为 $HOME/gowork）

$ mkdir $HOME/gowork
$ export GOPATH=$HOME/gowork

作为约定，将此工作空间的 bin 子目录添加到的 PATH 中：

$ export PATH=$PATH:$GOPATH/bin

执行这些配置

$ source $HOME/.profile

检查配置

$ go env

包路径

标准库中的包有给定的短路径，比如 "fmt" 和 "net/http"。 对于你自己的包，你必须选择一个基本路径，来保证它不会与将来添加到标准库， 或其它扩展库中的包相冲突。

我们将使用 github.com/user 作为基本路径。在你的工作空间里创建一个目录， 我们将源码存放到其中：

$ mkdir -p $GOPATH/src/github.com/user

你的第一个程序

要编译并运行简单的程序，首先要选择包路径（我们在这里使用 github.com/user/hello），并在你的工作空间内创建相应的包目录：

$ mkdir $GOPATH/src/github.com/user/hello

接着，在该目录中创建名为 hello.go 的文件

$ cd $GOPATH/src/github.com/user/hello
$ code hello.go

编辑 hello.go 文件，其内容为以下Go代码：

package main

import "fmt"

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

现在你可以用 go 工具构建并安装此程序了：

$ go install github.com/user/hello

注意，你可以在系统的任何地方运行此命令。go 工具会根据 GOPATH 指定的工作空间，在 github.com/user/hello 包内查找源码。

此命令会构建 hello 命令，产生一个可执行的二进制文件。 接着它会将该二进制文件作为 hello（在 Windows 下则为 hello.exe ）安装到工作空间的 bin 目录中。

现在，你可以在命令行下输入它的完整路径来运行它了：

$ $GOPATH/bin/hello
Hello, world.

创建 git 本地仓库

推荐的 Git 快速入门教程：

• Git教程 （本文由 廖雪峰 创作，如果觉得本教程对您有帮助，可以去 iTunes 购买）
• Git-Cheat-Sheet （作为Git教程的补充）

个人对于 Git 的学习和使用经验

若你是第一次使用 Git 则还需要进行如下配置：

$ git config --global user.name "your name"
$ git config --global user.email "[email protected]"

进入 hello.go 源代码所在目录，在该目录下使用 git init 初始化本地 git 仓库：

$ cd $GOPATH/src/github.com/user/hello
$ git init
Initialized empty Git repository in /home/user/work/src/github.com/user/hello/.git/

使用 git add 把文件添加到暂存区，然后使用 git commit 把暂存区的文件更新到仓库（版本库）

$ git add hello.go
$ git commit -m "initial commit"
[master (root-commit) 0b4507d] initial commit
 1 file changed, 1 insertion(+)
  create mode 100644 hello.go

创建 github 远程仓库并建立与本地 git 仓库的绑定

首先，登陆Github，点击“Repositories”，找到“New”并点击。

在 Repository name 处填入远程仓库名，比如 learngo，其他保持默认配置，然后点击“Create repository”从而创建了一个新的Git仓库。

如上图所示，你可以使用 https协议操纵远程仓库，也可以使用 git 协议。

如果使用 https协议，那么每次 pull 或 push 都会提示要输入密码；而如果使用 git 协议，那么就没有这个要求。注意，初次使用 Git 的用户若要使用 git 协议还需要额外做一些工作：生成密钥对，设置远程仓库上的公钥等等，在 Git 教程中都有提及，不再赘述。

根据作业的要求，我们使用 https 协议，这也免去了使用 git 协议额外需要做的工作

$ git remote add origin https://github.com/user-name/repo-name.git

使用 git remote 查看是否成功建立联系

$ git remote -v

出现类似如下情况则表示本地 git 仓库已经成功绑定到远程 github 仓库

将本地提交推送到远程仓库

$ git push -u origin master

你的第一个库

让我们编写一个库，并让 hello 程序来使用它。

同样，第一步还是选择包路径（我们将使用 github.com/user/stringutil） 并创建包目录：

$ mkdir $GOPATH/src/github.com/user/stringutil

接着，在该目录中创建名为 reverse.go 的文件，内容如下：

// stringutil 包含有用于处理字符串的工具函数。
package stringutil

// Reverse 将其实参字符串以符文为单位左右反转。
func Reverse(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)
}

现在用 go build 命令来测试该包的编译：

$ go build github.com/user/stringutil

这不会产生输出文件。想要输出的话，必须使用 go install 命令，它会将包的对象放到工作空间的 pkg 目录中。

确认 stringutil 包构建完毕后，修改原来的 hello.go 文件（它位于 $GOPATH/src/github.com/user/hello）去使用它：

package main

import (
	"fmt"

	"github.com/user/stringutil"
)

func main() {
	fmt.Printf(stringutil.Reverse("!oG ,olleH"))
}

无论是安装包还是二进制文件，go 工具都会安装它所依赖的任何东西。 因此当我们通过

$ go install github.com/user/hello

来安装 hello 程序时，stringutil 包也会被自动安装。

运行此程序的新版本，你应该能看到一条新的，反向的信息：

$ hello
Hello, Go!

做完上面这些步骤后，你的工作空间应该是这样的：

bin/
	hello                 # 可执行命令
pkg/
	linux_amd64/          # 这里会反映出你的操作系统和架构
		github.com/user/
			stringutil.a  # 包对象
src/
	github.com/user/
		hello/
			hello.go      # 命令源码
		stringutil/
			reverse.go       # 包源码

注意 go install 会将 stringutil.a 对象放到 pkg/linux_amd64 目录中，它会反映出其源码目录。 这就是在此之后调用 go 工具，能找到包对象并避免不必要的重新编译的原因。 linux_amd64 这部分能帮助跨平台编译，并反映出你的操作系统和架构。

Go的可执行命令是静态链接的；在运行Go程序时，包对象无需存在。

包名

Go源文件中的第一个语句必须是

package 名称

这里的 名称 即为导入该包时使用的默认名称。 （一个包中的所有文件都必须使用相同的 名称。）

Go的约定是包名为导入路径的最后一个元素：作为 “crypto/rot13” 导入的包应命名为 rot13。

可执行命令必须使用 package main。

链接成单个二进制文件的所有包，其包名无需是唯一的，只有导入路径（它们的完整文件名） 才是唯一的。

测试

Go拥有一个轻量级的测试框架，它由 go test 命令和 testing 包构成。

你可以通过创建一个名字以 _test.go 结尾的，包含名为 TestXXX 且签名为 func (t *testing.T) 函数的文件来编写测试。 测试框架会运行每一个这样的函数；若该函数调用了像 t.Error 或 t.Fail这样表示失败的函数，此测试即表示失败。

我们可通过创建文件 $GOPATH/src/github.com/user/stringutil/reverse_test.go 来为 stringutil 添加测试，其内容如下：

package stringutil

import "testing"

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

接着使用 go test 运行该测试：

$ go test github.com/user/stringutil
ok  	github.com/user/stringutil 0.165s

远程包

像 Git 或 Mercurial 这样的版本控制系统，可根据导入路径的描述来获取包源代码。go 工具可通过此特性来从远程代码库自动获取包。

若你在包的导入路径中包含了代码仓库的URL，go get 就会自动地获取、 构建并安装它：

$ go get github.com/golang/example/hello
$ $GOPATH/bin/hello
Hello, Go examples!

若指定的包不在工作空间中，go get 就会将会将它放到 GOPATH 指定的第一个工作空间内。（若该包已存在，go get 就会跳过远程获取， 其行为与 go install 相同）

在执行完上面的go get 命令后，工作空间的目录树看起来应该是这样的：

bin/
	hello                 # 可执行命令
pkg/
	linux_amd64/
		code.google.com/p/go.example/
			stringutil.a     # 包对象
		github.com/user/
			stringutil.a     # 包对象
src/
	code.google.com/p/go.example/
		hello/
			hello.go      # 命令源码
		stringutil/
			reverse.go       # 包源码
			reverse_test.go  # 测试源码
	github.com/user/
		hello/
			hello.go      # 命令源码
		stringutil/
			reverse.go       # 包源码
			reverse_test.go  # 测试源码

安装 go 的一些工具

进入 VS code，它提示要安装一些 go 工具，但不出意外这总会是 failed to install。幸运的是，我们还可以有其他的解决方案。

下载源代码到本地

# 创建文件夹
mkdir $GOPATH/src/golang.org/x/
# 下载源码，这一步可能需要较长时间的等待
go get -d github.com/golang/tools
# copy 
cp $GOPATH/src/github.com/golang/tools $GOPATH/src/golang.org/x/ -rf

安装工具包

$ go install golang.org/x/tools/go/buildutil

退出 vscode，再进入，按提示安装！

解决方案细节参考： 获取Golang.org上的Golang Packages

安装与运行 go tour

$ go get github.com/Go-zh/tour/gotour
$ gotour