原文：How to Write Go Code

一些基本概念

下载 & 安装：https://golang.org/doc/install
go tool：安装好 Go 之后自带的 cmd 工具，用于 fetch, build and install Go packages.
workspace：每一个 Go 的项目代码都存储在一个 workspace 里
一个 workspace 可能包含多个版本管理的 repository（后面用 repo 简写）
每一个 repo 里可能包含一个或多个 packages
每一个 package 在一个文件夹里包含一个或多个 Go 源码文件
一个 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 executable
    outyet                         # command executable
src/
    github.com/golang/example/
        .git/                      # Git repository metadata
	hello/
	    hello.go               # command source
	outyet/
	    main.go                # command source
	    main_test.go           # test source
	stringutil/
	    reverse.go             # package source
	    reverse_test.go        # test source
    golang.org/x/image/
        .git/                      # Git repository metadata
	bmp/
	    reader.go              # package source
	    writer.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 main

import "fmt"

func main() {
    fmt.Println("Hello, world.")
}

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

$ go install github.com/user/hello

这个命令会触发：

找到 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 即可

构建 hello 命令，并生成一个可执行的 binary 文件
安装这个 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 main

import (
	"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 source
        stringutil/
            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 metadata
        hello/
            hello.go                # command source
        stringutil/
            reverse.go              # package source
            reverse_test.go         # test source
    github.com/user/
        hello/
            hello.go                # command source
        stringutil/
            reverse.go              # package source
            reverse_test.go         # test source

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

NEXT

Effective Go 学习如何写出规范的 Go 代码: https://golang.org/doc/effective_go.html
A Tour of Go 学习语言: https://tour.golang.org/
官方文档：https://golang.org/doc/

References:

Go Website: https://golang.org/
How to Write Go Code: https://golang.org/doc/code.html
Set GOPATH: https://golang.org/wiki/SettingGOPATH