$ sudo tar -C /usr/local -xzf go1.13.linux-amd64.tar.gz

• API：Go API 检查器的辅助文件，记录了各个版本的 API 特性。
• bin：Go 语言相关的工具的二进制命令。
• doc：存放文档。
• lib：一些第三方库。
• misc：编辑器和开发环境的支持插件。
• pkg：存放不同平台的标准库的归档文件（.a 文件）。
• src：所有实现的源码。
• test：存放测试文件。

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/Go

$ go get golang.org/x/tools/cmd/godoc

$ godoc package [name ...]

• -http=:PORT：指定监听的地址，默认是 :6060。
• -index：支持关键词索引。
• -play：支持 Go 语言的 playground，用户可以在浏览器里面对 Go 语言进行测试。

$ godoc -http=:6060 -index -play

$ go build .

• -x 参数：可以打印出执行过程的详细信息，辅助调试。
• -gcflags：指定编译器参数。
• -ldflags：指定链接器参数，常见的可以通过 -X 来动态指定包变量值。

$ go clean

• -i 参数：删除 go install 安装的文件。
• -n 参数：打印删除命令，而不执行，方便进行测试检查。
• -r 参数：递归清除，对依赖包也执行清理工作。
• -x 参数：执行清除过程同时打印执行的删除命令，方便进行测试检查。

$ go env [var ...]

$ go env
GOARCH="amd64"
GOBIN=""
GOEXE=""
GOHOSTARCH="amd64"
GOHOSTOS="darwin"
GOOS="darwin"
GOPATH="/opt/Go"
GORACE=""
GOROOT="/usr/local/go/1.8.3/libexec"
GOTOOLDIR="/usr/local/go/1.8.3/libexec/pkg/tool/darwin_amd64"
GCCGO="gccgo"
CC="clang"
GOGCCFLAGS="-fPIC -m64 -pthread -fno-caret-diagnostics -Qunused-arguments -fmessage-length=0 -fdebug-prefix-map=/var/folders/d8/3h28zg552853gpp7ymrxl2r80000gn/T/go-build128111214=/tmp/go-build -gno-record-gcc-switches -fno-common"
CXX="clang++"
CGO_ENABLED="1"
PKG_CONFIG="pkg-config"
CGO_CFLAGS="-g -O2"
CGO_CPPFLAGS=""
CGO_CXXFLAGS="-g -O2"
CGO_FFLAGS="-g -O2"
CGO_LDFLAGS="-g -O2"

$ gofmt [flags] [path ...]

• -d 参数：仅显示不符合格式规定的地方，不进行修正。
• -e 参数：打印完整错误内容，默认是只打印 10 行。
• -l 参数：列出不符合格式规定的文件路径。
• -r 参数：重写的规则。
• -s 参数：对代码尝试进行简化。
• -w 参数：对不符合默认风格的代码进行修正。

$ go get github.com/hyperledger/fabric

• -u 参数：可以强制更新到最新版。
• -d 参数：仅获取软件包，不执行编译安装。

$ go list [-e] [-f format] [-json] [build flags] [packages]

$ go test ./...

• -v 参数：可以参数来打开详细测试日志，辅助调试。

$ go get -u github.com/golang/lint/golint

$ golint $GOPATH/src/github.com/hyperledger/fabric/...

$ go get golang.org/x/tools/cmd/goimports

• fix 命令可以对自动对旧版本的代码进行升级修复，替换为使用新版本的特性。
• trace 命令可以通过分析 trace 文件来追踪程序运行过程中的事件（包括 goroutine 的创建、使用和结束，以及系统调用和网络 IO 等底层事件），并提供图形化界面展示。例如如下命令会打开网页提供图形界面，展示程序执行情况。

$ go test -bench=. -trace trace.out
$ go tool trace trace.out

import (
    "http"
    _ "net/http/pprof"
)
func main() {
    // 提供 profiling web 界面 localhost:6060/debug/pprof
    go func() {
        http.ListenAndServe("localhost:6060", nil)
    }()
    // 应用程序代码
}

package main
import (
    "flag"
    "fmt"
    "log"
    "os"
    "runtime"
    "runtime/pprof"
    "time"
    "github.com/pkg/errors"
)
func testTimeout() error{
    incChan := make(chan int, 1)
    errChan := make(chan error, 1)
    timeout := 10 * time.Millisecond
    go func() {
        incChan <- 1
    }()
    select {
    case <-time.NewTicker(timeout).C:
        fmt.Println("Ticker")
        return errors.Errorf("Timed out waiting for connection message")
    case m := <-incChan:
        fmt.Printf("incChan: %d\n", m)
        return nil
    case err := <-errChan:
        fmt.Println("errChan")
        return errors.WithStack(err)
    }
}
var cpuprofile = flag.String("cpuprofile", "cpu.prof", "write cpu profile to `file`")
var memprofile = flag.String("memprofile", "mem.prof", "write memory profile to `file`")
func main() {
    // 启用 CPU profiling
    flag.Parse()
    if *cpuprofile != "" {
        f, err := os.Create(*cpuprofile)
        if err != nil {
            log.Fatal("could not create CPU profile: ", err)
        }
        if err := pprof.StartCPUProfile(f); err != nil {
            log.Fatal("could not start CPU profile: ", err)
        }
        defer pprof.StopCPUProfile()
    }
    // 应用代码
    i := 1
    for i = 1; i <= 100; i++ {
        fmt.Println(i)
        go testTimeout()
        time.Sleep(time.Duration(1) * time.Second)
    }
    // 导出内存统计
    if *memprofile != "" {
        f, err := os.Create(*memprofile)
        if err != nil {
            log.Fatal("could not create memory profile: ", err)
        }
        runtime.GC() // get up-to-date statistics
        if err := pprof.WriteHeapProfile(f); err != nil {
            log.Fatal("could not write memory profile: ", err)
        }
        f.Close()
    }
}

说明：如果没有安装 pprof 工具，可以通过 go get -u github.com/google/pprof 快速安装。

$ pprof -http=localhost:6060 main cpu.prof

$ go get -u -v github.com/kardianos/govendor

• Gopkg.toml 文件：手动编写或通过 dep init 命令生成。描述了项目对第三库的依赖规则，例如允许的版本范围等。用户可以通过编辑该文件表达预期的依赖控制目标。
• Gopkg.lock 文件：通过 dep init 或 dep ensure 命令自动生成。根据项目代码和 Gopkg.toml 文件，计算出一个符合要求的具体的依赖关系并锁定，其中包括每个第三方库的具体版本。vendor 目录下的依赖库需要匹配这些版本。

$ go get -v -u github.com/golang/dep/cmd/dep

• init：对一个新的 Go 项目，初始化依赖管理，生成配置文件和 vendor 目录等；
• status：查看当前项目依赖的状态，包括依赖包名称、限制范围、指定版本等。可以通过 -old 参数来只显示过期的依赖；
• ensure：更新依赖，确保满足指定的版本条件。如果本地缺乏某个依赖，会自动安装；
• version：显示 dep 工具的版本信息。

• • add：添加新的依赖，如 dep ensure -add github.com/pkg/foo@^1.0.0；
• • dry-run：模拟执行，打印参考改动但不实施；
• • no-vendor：根据计算结果更新 Gopkg.lock 文件，但不更新 vendor 中依赖包；
• • update：更新 Gopkg.lock 中的依赖到 Gopkg.toml 中允许的最新版本，默认同时更新 vendor 包中内容；
• • v：输出调试信息方面了解执行过程；
• • vendor-only：按照 Gopkg.lock 中条件更新 vendor 包中内容。

• download：下载依赖模块到本地的缓存；
• edit：编辑 go.mod 文件；
• graph：查看当前的依赖结构；
• init：初始化，创建 go.mod 文件；
• tidy：整理依赖模块：添加新模块，并删除未使用模块；
• vendor：将依赖模块复制到本地的 vendor 目录，方便兼容原来的 vendor 方式（该命令未来会遗弃）；
• verify：校验当前依赖是否正确，未被篡改；
• why：解释为何需要某个依赖包。

• 使用 go mod init <module name> 来初始化本地的 go.mod 文件；
• 使用 go get -u <package name>@<version> 来获取某个依赖包（不添加版本号会默认获取当前最新），同时自动更新 go.mod 文件。更新全部模块可以使用 go get -u all；
• 编译时使用 go build -mod=readonly 可以避免在编译过程中修改 go.mod；
• 如果要使用本地的 vendor 目录进行编译，可以使用 go build -mod=vendor；
• 如果要检查可更新的依赖，可以使用 go list -m -u all。如果要执行更新，可以使用 go get -u；
• 此外，执行 go 相关命令（build、get、list、test 等）时，也会自动下载依赖并更新 go.mod 文件。

$ go env -w GO111MODULE=on # 记录到 os.UserConfigDir 指定路径（默认为 $HOME/.config/go/）下的 env 文件中