原文：How to Write Go Code

一些基本概念

1. 下载 & 安装：golang.org/doc/install
2. go tool：安装好 Go 之后自带的 cmd 工具，用于 fetch, build and install Go packages.
3. workspace：每一个 Go 的项目代码都存储在一个 workspace 里
4. 一个 workspace 可能包含多个版本管理的 repository（后面用 repo 简写）
5. 每一个 repo 里可能包含一个或多个 packages
6. 每一个 package 在一个文件夹里包含一个或多个 Go 源码文件
7. 一个 package 的文件夹路径就是它的 import path

go tool 对代码的组织结构有特定的要求

Workspaces

Def: 一个 workspace 是一个有特定文件结构 hierarchy 的文件夹，其中根目录下有两个文件夹：

• src：包含 Go 源代码
• bin：包含可执行命令

go tool 会构建（build）和安装（install）可执行代码（binaries）到 bin 文件夹中。src 文件夹下的子文件夹即会包含多个 repo。

For Example：

bin/hello                          # command executableoutyet                         # command executable
src/github.com/golang/example/.git/                      # Git repository metadatahello/hello.go               # command sourceoutyet/main.go                # command sourcemain_test.go           # test sourcestringutil/reverse.go             # package sourcereverse_test.go        # test sourcegolang.org/x/image/.git/                      # Git repository metadatabmp/reader.go              # package sourcewriter.go              # package source... (many more repositories and packages omitted) ...
复制代码

GOPATH 环境变量

Def：GOPATH 环境变量指向了你的 workspace 的位置。它在 Unix 的默认值是在你 Home 文件夹下的 $HOME/go 或是 Windows 里的 %USERPROFILE%\go（通常是 C:\Users\YourName\go）。

如果你希望设置多个不同的位置，可以通过设置 GOPATH 来解决。

GOPATH 不能与安装 Go 的位置一样

可以通过 go env GOPATH 看到目前的 GOPATH。

开放 workspace's 里的 bin 子目录到 PATH（就是在 $GOPATH/bin/ 下的 cmd 可以直接调用了）：

$ export PATH=$PATH:$(go env GOPATH)/bin
复制代码

设置 $GOPATH 到环境变量：

$ export GOPATH = $(go env GOPATH)
复制代码

Import paths

Def: 一个 import path 是代表一个 package 的唯一指代字段（String）。一个 package 的 import path 代表了其在一个 workspace 中的具体位置（也可能是一个远程 repo）。

• Standard library 中的 packages：可以用 short import paths 来引入，如："fmt" 和 "net/http"。
• 自己项目中的 packges：必须选择一个 base path 且避免与潜在其他 package、标准库 package、外部 package 有名字冲突。
• 远程 repo：使用远程 repo 的根地址为 base path。如：一个 GitHub 的用户名 github.com/user 作为 base path

在我们自己的电脑上，我们可以先设置一个 base path（注意，这里 user 你可以自己随便写）：

$ mkdir -p $GOPATH/src/github.com/user
复制代码

第一个 Program

我们来开发第一个项目，我们假设这个 package path 是 github.com/user/hello 并建立一个子文件夹作为 package 的文件夹：

$ mkdir $GOPATH/src/github.com/user/hello
复制代码

下一步则是建立一个文件 hello.go 作为源代码：

package mainimport "fmt"func main() {fmt.Println("Hello, world.")
}
复制代码

下一步就是用 go tool 来 build 和 install 这段代码：

$ go install github.com/user/hello
复制代码

这个命令会触发：

1. 找到 package 的位置：

• go tool 首先会通过 base path + package name 找到 workspace 里（因为 GOPATH 环境变量已经设置了 workspace 的位置）相应的 package path github.com/user/hello
• 如果你当前的文件夹在 package path 中，即 $ cd $GOPATH/src/github.com/user/hello，那么就可以直接输入 $ go install 即可

1. 构建 hello 命令，并生成一个可执行的 binary 文件
2. 安装这个 binary 文件到 workspace 的 bin 文件夹下并命名为 hello，即 $GOPATH/bin/hello

• 如果你上面已经通过把 $GOPATH/bin 加入到 $PATH 环境变量里，那么 hello 已经可以作为命令使用。

也就是如下效果：

$ $GOPATH/bin/hello
Hello, world.
复制代码

或

$ hello
Hello, world.
复制代码

第一个 Library

同样，像是建立一个 Program 一样，我们建立一个 Library 文件夹 stringutil：

$ mkdir $GOPATH/src/github.com/user/stringutil
复制代码

然后在 stringutil 文件夹里建立一个文件 reverse.go：

// Package stringutil contains utility functions for working with strings.
package stringutil// Reverse returns its argument string reversed rune-wise left to right.
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)
}
复制代码

也如同上面所说，我们来构建（build）它，逐一这里我们只 build 不 install 因为这是一个 Library：

$ go build github.com/user/stringutil
复制代码

构建好后，如果我们想在我们的 Program 中引用这个 stringutil Library 则通过更新 GOPATH/src/github.com/user/hello 中的 hello.go 文件：

package mainimport ("fmt""github.com/user/stringutil"
)func main() {fmt.Println(stringutil.Reverse("!oG ,olleH"))
}
复制代码

下一步，我们重新 install hello：

$ go install github.com/user/hello
复制代码

那么相应的 cmd hello 通过引用 stringutil Library 也有了新的输出：

$ hello
Hello, Go!
复制代码

这时，如果我们看 workspace 中的变化和文件结构就是：

bin/hello                 # command executable
src/github.com/user/hello/hello.go      # command sourcestringutil/reverse.go    # package source
复制代码

其中：

• bin/hello 是 install 之后的可执行 binary 程序
• github.com/user/hello 是 hello Program
• github.com/user/stringutil 是 stringutil Library

Package names

每一个 Go 源代码文件的第一行必须是：

package name
复制代码

而这里 name 是 package 被引用时的默认名。在 Go 语言的常规使用中，import path 的最后一个元素即为 package name，例如：package 通过 "crypto/rot13" 引用，那么这个 package 的名字应该是 rot13。

可运行的 cmd（也就是要被 install）的 binary 名必须是 main。而 package name 并不一定要不重复，只要 import paths 唯一即可。也就是 "util1/util" 和 "util2/util" 是不同的。

Testing

此处内容精炼，这里不做阐述了。

Remote packages 远程 packages

一个 import path 可以用来获取一个远程的 package（如 Git 或 Mercurial），go tool 会自动下载远程的 repo。例如，Go 官方的示例代码被存储在 GitHub 上，地址为 github.com/golang/example，使用 go get 命令即可自动 fetch, build and install，go get 会将 package 自动下载到 $GOPATH 中的第一个 workspace 中：

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

这个时候的 workspace 文件夹结构变成了：

bin/hello                           # command executable
src/github.com/golang/example/.git/                       # Git repository metadatahello/hello.go                # command sourcestringutil/reverse.go              # package sourcereverse_test.go         # test sourcegithub.com/user/hello/hello.go                # command sourcestringutil/reverse.go              # package sourcereverse_test.go         # test source
复制代码

这个时候，你可能会疑虑，就是 hello 之前是由 github.com/user/hello来定义的，而现在被 github.com/golang/example/hello 覆盖。

NEXT

1. Effective Go 学习如何写出规范的 Go 代码: golang.org/doc/effecti…
2. A Tour of Go 学习语言: tour.golang.org/
3. 官方文档：golang.org/doc/

References:

1. Go Website: golang.org/
2. How to Write Go Code: golang.org/doc/code.ht…
3. Set GOPATH: golang.org/wiki/Settin…