目录 [−]
官方原文: How to Write Go Code,
根据最新官方文档翻译。翻译参考wang_yb的如何写 go 代码 。
因为官方文档有更新,我根据新版本的文档重新进行了翻译。
本文演示如何开发一个简单的 go package, 以及 go tool 的使用方法,
即获取(fetch), 编译(build), 安装(install) go package 的标准方法和命令.
go tool 需要你按照一定的标准来组织代码. 请仔细阅读本文.
它介绍了用来构建和运行 Go 程序的最简单方法.
介绍本文的视频参照: https://www.youtube.com/watch?v=XCsL89YtqCs。
代码组织
工作区Workspace
go tool 是设计用来和公共仓库的开源代码一起工作的.
即使你不需要发布你的代码, go tool 的工作模型也同样适用于你.
Go 代码必须保存在 工作区 中, 工作区 就是一个特定的目录结构, 根目录下有如下3个目录:
- src 目录: 存放 go 源码文件, 按 package 来组织 (一个 package 一个文件夹)
- pkg 目录: 存放 package 对象
- bin 目录: 存放可执行的命令command
go tool 编译 src 下的文件, 并将编译好的二进制文件分别放入 pkg 或者 bin 文件夹中.
src 目录可以包含多个 版本控制仓库(比如 Git 或 Mercurial), 用来管理代码的开发.
一个实际的工作区的目录结构如下:
|
|
这个工作区包含一个仓库(example),由两个命令组成(hello和outyet),以及一个库(stringutil)。
一个典型的工作区可能包含很多源码库,这些源码库包含着N多的package和command。大部分的Go程序员会将他们的源码和依赖放在一个单一的工作区中。
命令Command和库libraries由各种source package编译而来。我们稍后再介绍它。
GOPATH 环境变量
GOPATH
环境变量指向你的 工作区 的位置. 这是你开发 Go 代码时唯一需要设置的环境变量.
开始开发时, 创建 工作区 的文件夹, 并设置对应的 GOPATH
环境变量.
你的 工作区 可以是任意文件夹, 本文中使用的路径是 $HOME/work
注意 不要把 GOPATH
设置为 go 的安装路径. (另一种常用设置方式是设置GOPATH=$HOME
)
|
|
为了方便编译出的命令的执行, 将上面的 bin 目录加入到 PATH:
|
|
想了解更多设置GOPATH 环境变量的知识,可以查看go help gopath
Package路径
标准库中的 package 只要使用短路径即可, 比如 "fmt", "net/http"。
对于自己的 package, 必须选一个基本路径以防止以后和标准库, 或者其他第三方的库产生冲突。
如果你的代码保存在某个代码仓库, 那么就可以使用那个代码仓库的根目录作为你的 package 的基本路径。
比如, 你有个 github 的账户在 github.com/user
, 就可以使用 github.com/user
作为你的基本路径。
注意 在能够正确编译代码之前, 你并不需要发布你的代码到远程的代码仓库。
但是如果有一天你发布代码的话, 组织好你的代码是个好习惯。
实际上, 你可以使用任意的路径名称, 只要它在 go 标准库和庞大的 go 生态系统中是唯一的。
我们使用 "github.com/user" 作为基本路径, 然后在工作区中创建文件夹来保存代码:
|
|
第一个 Go 程序
为了编译和运行一个简单的 GO 程序, 首先要确定 package 路径(这里使用 github.com/user/hello),
并且在工作区中创建对应 package 文件夹.
|
|
下一步, 在上面文件夹中创建 hello.go 文件, 文件内容如下:
|
|
然后, 可以通过 go tool 来编译和安装上面的 hello 程序。
|
|
注意 你可以在任何路径下运行上述命令, go tool 会根据 GOPATH 环境变量来从工作区中查找 github.com/user/hello。
如果在 package 所在文件夹中运行 go install, 也可以省略 package 路径。
|
|
上面的命令编译了 hello 命令, 并产生此命令的二进制可执行文件。
然后将二进制文件 hello 安装到了 工作区 的 bin 文件夹下(Windows 下是 hello.exe)
在我们的例子中, 就是 $GOPATH/bin/hello, 即 $HOME/work/bin/hello。
go tool 只有在出错时才会输出信息, 如果上面的 go 命令没有输出就说明执行成功了.
然后, 就可以在命令行中运行这个命令了.
|
|
或者, 如果你将 $GOPATH/bin 加入到 PATH 中了的话, 也可以执行执行 hello 命令。
|
|
如果你使用了代码版本管理工具, 正好可以初始化你的仓库, 添加文件, 并 commit 你的第一个改变。
当然这个步骤是可选的, 写 go 代码并不强制要求使用代码版本管理工具。
|
|
你可以把发布这个仓库作为练习题。
第一个Go库
让我们来写一个库, 并将之用于上面的 hello 程序中.
同样, 首先确定 package 路径 (这里使用 github.com/user/stringutil), 并创建对应的文件夹。
|
|
接着, 创建文件 reverse.go, 内容如下:
|
|
用 go build 来编译此 package:
|
|
或者在 package 的目录下, 直接运行 go build
|
|
上面的命令不会产生输出文件。 为了生成输出文件, 必须使用 go install
命令, 它会在 pkg 文件夹下生成 package 对象.
stringutil package 编译成功之后, 修改之前的 hello.go 文件:
|
|
无论用 go tool 安装 package 对象还是 二进制文件, 它都会安装所有的依赖.
所以当你安装 hello 程序时,
|
|
stringutil package 也会被自动安装.
运行新的 hello 程序, 可以看到如下输出:
|
|
经过上面的步骤, 你的 工作区应该像下面这样:
|
|
注意 go install 将 stringutil.a 放进了 pkg/linux_amd64 文件夹下与源码对应的目录中。
以后, go tool 就可以找到这个 package, 从而判断是否需要重新编译。
linux_amd64 是表示当前使用的系统, 它的目的是为了区分交叉编译出的其他平台的 package。
Go 编译出的二进制文件都是静态链接的, 所以上面的 bin/hello 在执行时并不需要 linux_amd64/go-files/stringutil.a 文件。
Package name
go 代码文件的第一行必须是:
|
|
这里的 name 作为 package 的默认名称, 让其他 package import 的时候用.(同个 package 中的所有文件必须使用相同的 name)。
Go 约定 package name 是 import path 中最后一部分。
也就是说, 如果一个 package 被引用时写成 "crypto/rot13", 那么这个 package 的 name 就是 rot13。
编译为可执行文件的代码的 package name 必须是 main。
连接进同一个二进制文件的package name 不一定要唯一, 只要 pakage 的 import path 是唯一的就行。
也就是上面的 crypto/rot13 必须唯一, 但是可以有 another-crypto/rot13。
Go 的命名规则可以参考: [Effective Go](http://golang.org/doc/effective_go.html#names)
测试
Go 中包含一个轻量级的测试框架, 由 go test
命令和 testing package
组成。
测试文件的名称以 _test.go
结尾, 其中包含格式如 func TestXXXX(t *testing.T)
的函数。
测试框架会执行每个这样的函数, 如果函数中调用了 t.Error
或者 t.Fail
, 就认为测试失败。
给上面的 package stringutil 增加测试文件, 路径: $GOPATH/src/github.com/user/stringutil/reverse_test.go , 内容如下:
|
|
运行测试的方法如下:
|
|
或者进入到 package stringutil 的目录中后, 直接运行:
|
|
通过 go help test 或者 http://golang.org/pkg/testing/ 来进一步 GO 的测试框架。
远程 package
Go 的 import path 指示如何从版本管理系统(Git 或者 Mercurial) 中获取 package 的源码。go tool 可以利用这个特性来自动获取远程仓库的代码。
比如, 下面的例子中使用的代码同时也保存在 github 上(http://github.com/golang/example)。
如果你在代码中 import 了上面这个远程的 package, 那么 go get 命令会自动 获取, 编译, 安装这个 package。
|
|
如果工作区中没有指定的 package,go get
命令会把这个 package 下载到 GOPATH 中定义的第一个工作区中。
(如果这个package已经存在,go get
会跳过获取这一步,执行go install
相同的行为)
上面的 go get 命令执行之后, 文件夹结构大致如下:
|
|
github.com 上的 hello 程序依赖同一个仓库中的 package stringutil,
即 github.com 上的 hello.go 中引用了 github.com 上的 package stringutil, 所以, go get 命令也下载, 编译, 安装了 stringutil 模块。
|
|
这个特性可以让你的 go package 很容易的被别人使用.
Go Wiki 和 godoc.org 上列出了很多第三方 Go 工程。
关于使用 go tool 来使用远程仓库的更多信息, 请参考: go help importpath
下一步
- 订阅 golang-announce 邮件列表来了解最新的 Go release 信息
- 将 Effective Go 作为参考资料来编写整洁, 地道的 Go 代码
- 通过 A Tour of Go 来完成一次 go 的旅行
- 访问 documentation page 来了解一系列关于Go语言的有深度的文章, 以及 Go 库和工具.
寻求帮助
- 寻求实时帮助, 可以使用 FreeNode 的IRC server #go-nuts
- Go 语言官方邮件列表 Go Nuts
- 汇报 Go 语言的 bug 请使用 Go issue tracker
有疑问加站长微信联系(非本文作者)