Go Book
Go Book / 1 Go Basics / 02 Go安装和常用工具

02 Go安装和常用工具

一、Go安装

Go定位为系统级别的编程语言，类似C的gcc编译器，Go提供编译器的安装，Go编码完成后通过编译器生成可执行文件。国内Go语言中文网提供各种版本的安装包：Go语言中文网，下载对于的系统平台和版本即可。

1.自动安装

Mac OS X

mac平台一般都有最新的go版本，使用brew工具安装即可：

brew install go
Linux 发行版

Linux各发行版都有各自的安装工具，可能很多远程仓库都没有实时更新版本，可考虑下载.tag.gz包安装

//ubuntu && debian
apt-get install go

//centos && redhat
yum install go

2.Linux、Mac OS X 和 FreeBSD 的安装包

下载此压缩包并提取到 /usr/local 目录，在 /usr/local/go 中创建Go目录树。例如：

tar -C /usr/local -xzf go$VERSION.$OS-$ARCH.tar.gz

该压缩包的名称可能不同，这取决于你安装的Go版本和你的操作系统以及处理器架构。

（此命令必须作为root或通过 sudo 运行。）

要将 /usr/local/go/bin 添加到 PATH 环境变量， 你需要将此行添加到你的 /etc/profile（全系统安装）或 $HOME/.profile 文件中：

export PATH=$PATH:/usr/local/go/bin
安装到指定位置

Go二进制发行版假定它们会被安装到 /usr/local/go （或Windows下的 c:\Go）中，但也可将Go工具安装到不同的位置。 此时你必须设置 GOROOT 环境变量来指出它所安装的位置。

例如，若你将Go安装到你的home目录下，你应当将以下命令添加到 $HOME/.profile 文件中：

export GOROOT=$HOME/go
export PATH=$PATH:$GOROOT/bin

注：GOROOT 仅在安装到指定位置时才需要设置。

3.Windows 安装

win平台都是下载软件包可视化安装，这个不展开了。

二、关于GOPATH、GOROOT、GOBIN

Go初学者一般比较容易搞混的地方，首先看一下go安装后的环境

fun@Terminal：~ go env
GOARCH="amd64"
GOBIN="/Users/fun/Code/go/bin"  
GOCACHE="/Users/fun/Library/Caches/go-build"
GOEXE=""
GOFLAGS=""
GOHOSTARCH="amd64"
GOHOSTOS="darwin"
GOOS="darwin"
GOPATH="/Users/fun/Code/go"
GOPROXY=""
GORACE=""
GOROOT="/usr/local/Cellar/go/1.12.1/libexec"
GOTMPDIR=""
GOTOOLDIR="/usr/local/Cellar/go/1.12.1/libexec/pkg/tool/darwin_amd64"
GCCGO="gccgo"
CC="clang"
CXX="clang++"
CGO_ENABLED="1"
GOMOD=""
CGO_CFLAGS="-g -O2"
CGO_CPPFLAGS=""
CGO_CXXFLAGS="-g -O2"
CGO_FFLAGS="-g -O2"
CGO_LDFLAGS="-g -O2"
PKG_CONFIG="pkg-config"
GOGCCFLAGS="-fPIC -m64 -pthread -fno-caret-diagnostics -Qunused-arguments -fmessage-length=0 -fdebug-prefix-map=/var/folders/dz/wqq5b88d6kg18cytgknfvw5m0000gn/T/go-build664645160=/tmp/go-build -gno-record-gcc-switches -fno-common"

以上可以看到GO相关环境变量，其中最重要的有以下三个：

1.GOPATH

go编译器查找导入包时，会在GOPATH定义的目录优先查找，也是Go源码通常存放的位置。Go1.5支持vendor机制后，GOPATH定义的位置降为次先查找。

2.GOROOT

Go编译器安装位置

3.GOBIN

go install 后的可执行文件存放目录

三、IDE或编辑器

  • Goland ：由jetbrain开发的神级IDE，开发效率极佳。
  • LiteIDE ： 由国人开发的免费IDE
  • VSCode/Sublime/Atom + go插件 ：非常流行的轻量级代码编辑器，安装相关Go插件也可以玩的溜。

四、Go运行及基本工具命令

go version

打印当前安装的go版本号

go version go1.12.1 darwin/amd64

go env

打印当前安装的go 环境信息

GOARCH="amd64"
GOBIN="/Users/xxx/Code/go/bin" //你写代码go install编译后程序存放的目录，加入系统PATH可直接运行
GOCACHE="/Users/xxx/Library/Caches/go-build" 
GOEXE=""
GOFLAGS=""
GOHOSTARCH="amd64"
GOHOSTOS="darwin"
GOOS="darwin"
GOPATH="/Users/xxx/Code/go" //你的代码存放目录
GOPROXY=""
GORACE=""
GOROOT="/usr/local/Cellar/go/1.12.1/libexec" //你安装go编译器的目录
GOTMPDIR=""
GOTOOLDIR="/usr/local/Cellar/go/1.12.1/libexec/pkg/tool/darwin_amd64"
GCCGO="gccgo"
CC="clang"
CXX="clang++"
CGO_ENABLED="1"
GOMOD=""
CGO_CFLAGS="-g -O2"
CGO_CPPFLAGS=""
CGO_CXXFLAGS="-g -O2"
CGO_FFLAGS="-g -O2"
CGO_LDFLAGS="-g -O2"
PKG_CONFIG="pkg-config"
GOGCCFLAGS="-fPIC -m64 -pthread -fno-caret-diagnostics -Qunused-arguments -fmessage-length=0 -fdebug-prefix-map=/var/folders/dz/wqq5b88d6kg18cytgknfvw5m0000gn/T/go-build054488258=/tmp/go-build -gno-record-gcc-switches -fno-common"

go get

一键获取代码、编译并安装

usage: go get [-d] [-f] [-t] [-u] [-v] [-fix] [-insecure] [build flags] [packages]

-d	只下载，不安装
-f
-t
-u	下载丢失的包，但不会更新已经存在的包
-v	显示操作流程的日志及信息，方便检查错误
-fix 
-insecure	允许使用不安全的 HTTP 方式进行下载操作
build flag
packages

默认直接 “go get + 远程包”， 下载完后可以直接使用。 大多数开源项目被托管于 Github.com，都是基于git版本控制工具管理，下载后的包通常都在gopath下的src目录下，使用时在代码import位置直接导入包全名即可，如：

import github.com/jinzhu/gorm

其中

  • github.com 为代码仓库域名
  • jinzhu 为作者或机构名
  • gorm 就是实际引用的包名了

go build

usage: go build [-o output] [-i] [build flags] [packages]

-o 设置输出编译后文件目录和文件名
-i 安装作为目标依赖项的包
[build flags]
[packages]

go install

usage: go install [-i] [build flags] [packages]

-i 安装命名包的依赖项
[build flags]
[packages]
go build 和 go install 区别
  • go build 只对main包有效，在当前目录编译生成一个可执行的二进制文件（依赖包生成的静态库文件放在$GOPATH/pkg）
  • go install 分两种情况：
  • 1.如果为main包，会在$GOPATH/bin生成一个可执行的二进制文件。其依赖包会生成静态库文件放在$GOPATH/pkg。
  • 2.如果只是库包（没有main），一般生成静态库文件放在$GOPATH/pkg目录下，文件扩展名a.

go run

该命令会编译源码，并且直接执行源码的 main() 函数，不会在当前目录留下可执行文件。

go run 不会在运行目录下生成任何文件，可执行文件被放在临时文件中被执行，工作目录被设置为当前目录。在 go run 的后部可以添加参数，这部分参数会作为代码可以接受的命令行输入提供给程序。

go run 不能使用“go run+包”的方式进行编译，如需快速编译运行包，需要使用如下步骤来代替：

  1. 使用 go build 生成可执行文件。
  2. 运行可执行文件。

go doc & godoc

一般go doc 生成文档

usage: go doc [-u] [-c] [package|[package.]symbol[.methodOrField]]

    go doc
		显示当前包的文档
	go doc Foo
		在当前包中显示Foo的文档。（Foo以大写字母开头，因此无法匹配包路径。）
	go doc encoding/json
		显示 encoding/json 包文档.
	go doc json
		encoding/json 简写
	go doc json.Number (or go doc json.number)
		显示json.Number的文档和方法摘要
	go doc json.Number.Int64 
		显示json.Number.Int64()方法的文档
	go doc cmd/doc
		显示doc命令的包文档。
	go doc -cmd cmd/doc
		在DOC命令中显示包文档和导出的符号。
	go doc template.new
		显示HTML/模板新函数的文档。
        （HTML/template在词汇上位于text/template之前）

godoc -http=localhost:port 在本地网页上查看结构化文档

usage: godoc -http=localhost:6060
  -analysis string
    	comma-separated list of analyses to perform (supported: type, pointer). See http://golang.org/lib/godoc/analysis/help.html
  -goroot string
    	Go root directory (default "/usr/local/Cellar/go/1.12.1/libexec")
  -http string
    	HTTP service address (default "localhost:6060")
  -index
    	enable search index
  -index_files string
    	glob pattern specifying index files; if not empty, the index is read from these files in sorted order
  -index_interval duration
    	interval of indexing; 0 for default (5m), negative to only index once at startup
  -index_throttle float
    	index throttle value; 0.0 = no time allocated, 1.0 = full throttle (default 0.75)
  -links
    	link identifiers to their declarations (default true)
  -maxresults int
    	maximum number of full text search results shown (default 10000)
  -notes string
    	regular expression matching note markers to show (default "BUG")
  -play
    	enable playground
  -templates string
    	load templates/JS/CSS from disk in this directory
  -timestamps
    	show timestamps with directory listings
  -url string
    	print HTML for named URL
  -v	verbose mode
  -write_index
    	write index to a file; the file name must be specified with -index_files
  -zip string
    	zip file providing the file system to serve; disabled if empty

go fmt

代码格式化工具，一般现在IDE每次保存时都会自动执行该工具命令，这保证了不同开发者编写代码格式统一。

go test

Go的测试及性能调试工具，具体用法会在《GO测试篇》提到。

go bug

go 调试工具

go tool

Go工具包： 常用go tool pprof性能检查工具, go tool cgo跟C语言和GO语言有关的命令

go mod

Go 1.11版本后支持go modules包管理方案，此命令为对此的支持工具，具体用法在《Go包与包管理》提到。

go fix

简单的说，这是一个当GO语言版本升级之后，把代码包中旧的语法更新成新版本语法的自动化工具。它是 go tool fix 的简单封装，它作用于代码包。当需要升级自己的项目或者升级下载的第三方代码包，可以使用此方法。（下载并升级代码包可以使用 go get -fix 命令 ）

go vet

静态检测工具，一般用于性能优化。