引言
本文通过阅读官方文档如何使用Go编程 ,展示了一个简单Go包的开发,并介绍了用go工具来获取、 构建并安装Go包及命令的标准方式。go 工具需要你按照指定的方式来组织代码。
代码的组织
-
工作空间
go 工具为公共代码仓库中维护的开源代码而设计。 无论你会不会公布代码,该模型设置工作环境的方法都是相同的。
Go代码必须放在工作空间内。它其实就是一个目录,其中包含三个子目录:
src 目录包含Go的源文件,它们被组织成包(每个目录都对应一个包),
pkg 目录包含包对象,
bin 目录包含可执行命令。
go 工具用于构建源码包,并将其生成的二进制文件安装到 pkg 和 bin 目录中。
src 子目录通常包会含多种版本控制的代码仓库(例如Git或Mercurial), 以此来跟踪一个或多个源码包的开发。
以下例子展现了实践中工作空间的概念:
bin/
streak # 可执行命令
todo # 可执行命令
pkg/
linux_amd64/
code.google.com/p/goauth2/
oauth.a # 包对象
github.com/nf/todo/
task.a # 包对象
src/
code.google.com/p/goauth2/
.hg/ # mercurial 代码库元数据
oauth/
oauth.go # 包源码
oauth_test.go # 测试源码
github.com/nf/
streak/
.git/ # git 代码库元数据
oauth.go # 命令源码
streak.go # 命令源码
todo/
.git/ # git 代码库元数据
task/
task.go # 包源码
todo.go # 命令源码

- GOPATH 环境变量
GOPATH 环境变量指定了你的工作空间位置。它或许是你在开发Go代码时, 唯一需要设置的环境变量。
创建工作空间,工作空间可以在任何地方创建。
mkdir /home/username/gowork
接着将工作空间添加进环境变量中,打开/etc/profile,添加
export GOPATH= /home/username/gowork
export PATH= $ PATH:$GOPATH/bin

-
包路径
我使用 github.com/github-user 作为基本路径。在工作空间里创建一个目录, 将源码存放到其中:$ mkdir -p $GOPATH/src/github.com/user -
第一个程序
首先要选择包路径并在工作空间内创建相应的包目录:
$ mkdir $GOPATH/src/github.com/github-user/hello
然后在文件夹中创建hello.go并且输出helloworld
package main
import "fmt"
func main(){
fmt.Println("Hello,World!")
}

现在可以用 go 工具构建并安装此程序了:
$ go install github.com/user/hello
此命令会构建 hello 命令,产生一个可执行的二进制文件。 接着它会将该二进制文件作为 hello安装到工作空间的 bin 目录中。

将 $GOPATH/bin 添加到 PATH 中后,只需输入该二进制文件名即可:

现在初始化仓库,添加文件并提交你的第一次更改:
cd $GOPATH/src/github.com/github-user/hello
git init
git add hello.go
git commit -m "initial commit"

接下来可以将本地仓库中commit的文件推送到远程仓库:
git remote add origin https://github.com/TempterCyn/ServiceComputing.git
git push -u origin master

- 第一个库
编写一个库,并让 hello 程序来使用它。
同样,第一步还是选择包路径并创建包目录:
$ mkdir $GOPATH/src/github.com/user/stringutil
接着,在该目录中创建名为 reverse.go 的文件,内容如下:
package stringutil
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/github-user/stringutil
确认 stringutil 包构建完毕后,修改原来的 hello.go 文件去使用它:
package main
import (
"fmt"
"github.com/github-user/stringutil"
)
func main() {
fmt.Printf(stringutil.Reverse("!oG ,olleH"))
}

无论是安装包还是二进制文件,go 工具都会安装它所依赖的任何东西。 因此当我们通过
$ go install github.com/user/hello
来安装 hello 程序时,stringutil 包也会被自动安装。运行此程序的新版本,你应该能看到一条新的,反向的信息:

- 测试
Go拥有一个轻量级的测试框架,它由 go test 命令和 testing 包构成。
你可以通过创建一个名字以 _test.go 结尾的,包含名为 TestXXX 且签名为 func (t *testing.T) 函数的文件来编写测试。 测试框架会运行每一个这样的函数;若该函数调用了像 t.Error 或 t.Fail 这样表示失败的函数,此测试即表示失败。
我们可通过创建文件 $GOPATH/src/github.com/github-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/github-user/stringutil

- 远程包
像Git或Mercurial这样的版本控制系统,可根据导入路径的描述来获取包源代码。go 工具可通过此特性来从远程代码库自动获取包。例如,本文档中描述的例子也可存放到Google Code上的Mercurial仓库 code.google.com/p/go.example 中,若你在包的导入路径中包含了代码仓库的URL,go get 就会自动地获取、 构建并安装它:
go get github.com/golang/example/hello
$GOPATH/bin/hello
Hello, Go examples!

远程库的github连接:https://github.com/TempterCyn/ServiceComputing
总结
通过学习官方文档,我对如何使用go进行编程以及go语言的变成框架有了更深的了解,基本了解并掌握了go语言的框架并能够进行运用。除此之外,我对git的操作也更加熟练。总的来说,学习如何使用go变成让我收获了很多。
本文介绍如何使用Go语言编程,包括代码组织、包管理、构建、安装及测试等核心概念。通过实际示例,展示了如何创建并使用Go包,以及如何利用go工具进行自动化构建和测试。
568

被折叠的 条评论
为什么被折叠?



