@ -0,0 +1,23 @@ |
|||
# 1 GO环境配置 |
|||
|
|||
欢迎来到Go的世界,让我们开始探索吧! |
|||
|
|||
Go是一种新的语言,一种并发的、带垃圾回收的、快速编译的语言。它具有以下特点: |
|||
|
|||
- 它可以在一台计算机上用几秒钟的时间编译一个大型的Go程序。 |
|||
- Go为软件构造提供了一种模型,它使依赖分析更加容易,且避免了大部分C风格include文件与库的开头。 |
|||
- Go是静态类型的语言,它的类型系统没有层级。因此用户不需要在定义类型之间的关系上花费时间,这样感觉起来比典型的面向对象语言更轻量级。 |
|||
- Go完全是垃圾回收型的语言,并为并发执行与通信提供了基本的支持。 |
|||
- 按照其设计,Go打算为多核机器上系统软件的构造提供一种方法。 |
|||
|
|||
Go是一种编译型语言,它结合了解释型语言的游刃有余,动态类型语言的开发效率,以及静态类型的安全性。它也打算成为现代的,支持网络与多核计算的语言。要满足这些目标,需要解决一些语言上的问题:一个富有表达能力但轻量级的类型系统,并发与垃圾回收机制,严格的依赖规范等等。这些无法通过库或工具解决好,因此Go也就应运而生了。 |
|||
|
|||
在本章中,我们将讲述Go的安装方法,以及如何配置项目信息。 |
|||
|
|||
## 目录 |
|||
|
|||
![](images/navi1.png?raw=true) |
|||
|
|||
## links |
|||
* [目录](<preface.md>) |
|||
* 下一节: [安装Go](<01.1.md>) |
@ -0,0 +1,207 @@ |
|||
# 1.1安装 Go |
|||
|
|||
## Go的三种安装方式 |
|||
Go有多种安装方式,你可以选择自己喜欢的。这里我们介绍三种最常见的安装方式: |
|||
|
|||
- Go标准包安装:Go提供了方便的安装包,支持Windows、Linux、Mac等系统。这种方式适合快速安装,可根据自己的系统位数下载好相应的安装包,一路 next 就可以轻松安装了。**推荐这种方式** |
|||
- 第三方工具安装:目前有很多方便的第三方软件包工具,例如 Ubuntu 的 apt-ge t和 wget、Mac 的 homebrew 等。这种安装方式适合那些熟悉相应系统的用户。 |
|||
- Go源码安装:这是一种标准的软件安装方式。对于经常使用Unix类系统的用户,尤其对于开发者来说,从源码安装可以自己定制。 |
|||
|
|||
最后,如果你想在同一个系统中安装多个版本的Go,你可以参考第三方工具[GVM](https://github.com/moovweb/gvm),这是目前在这方面做得最好的工具,除非你知道怎么处理。 |
|||
|
|||
|
|||
## Go标准包安装 |
|||
|
|||
Go 提供了每个平台打好包的一键安装,这些包默认会安装到如下目录:/usr/local/go (Windows系统:c:\Go),当然你可以改变他们的安装位置,但是改变之后你必须在你的环境变量中设置如下信息: |
|||
|
|||
export GOROOT=$HOME/go |
|||
export GOPATH=$HOME/gopath (可选配置) |
|||
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin |
|||
|
|||
上面这些命令对于Mac和Unix用户来说最好是写入`.bashrc`或者`.zshrc`文件,对于windows用户来说当然是写入环境变量。 |
|||
|
|||
### 如何判断自己的操作系统是32位还是64位?(建议直接跳过, 现在操作系统一般都是 64位) |
|||
|
|||
我们接下来的Go安装需要判断操作系统的位数,所以这小节我们先确定自己的系统类型。 |
|||
|
|||
Windows系统用户请按Win+R运行cmd,输入`systeminfo`后回车,稍等片刻,会出现一些系统信息。在“系统类型”一行中,若显示“x64-based PC”,即为64位系统;若显示“X86-based PC”,则为32位系统。 |
|||
|
|||
Mac系统用户建议直接使用64位的,因为Go所支持的Mac OS X版本已经不支持纯32位处理器了。 |
|||
|
|||
Linux系统用户可通过在Terminal中执行命令`arch`(即`uname -m`)来查看系统信息: |
|||
|
|||
64位系统显示 |
|||
x86_64 |
|||
|
|||
32位系统显示 |
|||
i386 |
|||
|
|||
### Mac 安装 |
|||
|
|||
访问[下载地址][downlink],64位系统下载 go1.14.7.darwin-amd64.pkg,双击下载文件,一路默认安装点击下一步,这个时候go已经安装到你的系统中,默认已经在PATH中增加了相应的`~/go/bin`, 这个时候打开终端,输入`go` |
|||
32位系统下载go1.4.2.darwin-386-osx10.8.pkg( 新的版本已无32位下载 ) |
|||
|
|||
看到类似上面源码安装成功的图片说明已经安装成功 |
|||
|
|||
如果出现go的Usage信息,那么说明go已经安装成功了;如果出现该命令不存在,那么可以检查一下自己的PATH环境变中是否包含了go的安装目录。 |
|||
|
|||
### Linux 安装 |
|||
|
|||
访问[下载地址][downlink],64位系统下载go1.14.7.linux-amd64.tar.gz,32位系统下载go1.14.7.linux-386.tar.gz, |
|||
|
|||
直接使用 `tar -C /usr/local -xzf go1.4.7.linux-amd64.tar.gz` 解压到 local 目录 |
|||
设置PATH,`export PATH=$PATH:/usr/local/go/bin` |
|||
|
|||
假定你想要安装Go的目录为 `$GO_INSTALL_DIR`,后面替换为相应的目录路径。 |
|||
解压缩`tar.gz`包到安装目录下:`tar zxvf go1.14.7.linux-amd64.tar.gz -C $GO_INSTALL_DIR`。 |
|||
|
|||
设置PATH,`export PATH=$PATH:$GO_INSTALL_DIR/go/bin` |
|||
|
|||
然后执行`go` |
|||
|
|||
![](images/1.1.linux.png?raw=true) |
|||
|
|||
图1.2 Linux系统下安装成功之后执行go显示的信息 |
|||
|
|||
如果出现go的Usage信息,那么说明go已经安装成功了;如果出现该命令不存在,那么可以检查一下自己的PATH环境变中是否包含了go的安装目录。 |
|||
|
|||
### Windows 安装 ### |
|||
|
|||
访问[Golang 下载页][downlink],64 位请选择名称中包含 windows-amd64 的, 32 位请选择名称中包含 windows-386 的 msi 安装包。下载好后运行,不要修改默认安装目录 C:\Go\,若安装到其他位置会导致不能执行自己所编写的 Go 代码。安装完成后默认会在环境变量 Path 后添加 Go 安装目录下的 bin 目录 `C:\Go\bin\`,并添加环境变量 GOROOT,值为 Go 安装根目录 `C:\Go\` 。 |
|||
|
|||
**验证是否安装成功** |
|||
|
|||
在运行中输入 `cmd` 打开命令行工具,在提示符下输入 `go`,检查是否能看到 Usage 信息。输入 `cd %GOROOT%`,看是否能进入 Go 安装目录。若都成功,说明安装成功。 |
|||
|
|||
不能的话请检查上述环境变量 Path 和 GOROOT 的值。若不存在请卸载后重新安装,存在请重启计算机后重试以上步骤。 |
|||
|
|||
|
|||
## 第三方工具安装 |
|||
|
|||
### GVM |
|||
|
|||
gvm是第三方开发的Go多版本管理工具,类似ruby里面的rvm工具。使用起来相当的方便,安装gvm使用如下命令: |
|||
```sh |
|||
|
|||
bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer) |
|||
``` |
|||
安装完成后我们就可以安装go了: |
|||
```sh |
|||
|
|||
gvm install go1.14.7 |
|||
gvm use go1.14.7 |
|||
``` |
|||
也可以使用下面的命令,省去每次调用gvm use的麻烦: |
|||
gvm use go1.14.7 --default |
|||
|
|||
执行完上面的命令之后GOPATH、GOROOT等环境变量会自动设置好,这样就可以直接使用了。 |
|||
|
|||
### apt-get |
|||
Ubuntu是目前使用最多的Linux桌面系统,使用`apt-get`命令来管理软件包,我们可以通过下面的命令来安装Go,为了以后方便,应该把 `git` `mercurial` 也安装上: |
|||
```sh |
|||
|
|||
sudo apt-get install python-software-properties |
|||
sudo add-apt-repository ppa:gophers/go |
|||
sudo apt-get update |
|||
sudo apt-get install golang-stable git-core mercurial |
|||
``` |
|||
### wget |
|||
```sh |
|||
|
|||
wget https://storage.googleapis.com/golang/go1.14.7.linux-amd64.tar.gz |
|||
或 wget https://dl.google.com/go/go1.14.7.linux-amd64.tar.gz |
|||
|
|||
sudo tar -xzf go1.14.7.linux-amd64.tar.gz -C /usr/local |
|||
``` |
|||
|
|||
配置环境变量: |
|||
```sh |
|||
|
|||
export GOROOT=/usr/local/go |
|||
export GOBIN=$GOROOT/bin |
|||
export PATH=$PATH:$GOBIN |
|||
export GOPATH=$HOME/gopath (可选设置) |
|||
``` |
|||
或者使用: |
|||
```sh |
|||
sudo vim /etc/profile |
|||
``` |
|||
并添加下面的内容: |
|||
```sh |
|||
export GOROOT=/usr/local/go |
|||
export GOBIN=$GOROOT/bin |
|||
export PATH=$PATH:$GOBIN |
|||
export GOPATH=$HOME/gopath (可选设置) |
|||
``` |
|||
|
|||
重新加载 profile 文件 |
|||
```sh |
|||
source /etc/profile |
|||
``` |
|||
### homebrew |
|||
homebrew是Mac系统下面目前使用最多的管理软件的工具,目前已支持Go,可以通过命令直接安装Go,为了以后方便,应该把 `git` `mercurial` 也安装上: |
|||
|
|||
1.安装homebrew |
|||
|
|||
```sh |
|||
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" |
|||
``` |
|||
|
|||
2.安装go |
|||
|
|||
```sh |
|||
|
|||
brew update && brew upgrade |
|||
brew install go |
|||
brew install git |
|||
brew install mercurial // 可选安装 |
|||
``` |
|||
|
|||
## Go源码安装 |
|||
Go 1.5彻底移除 C 代码,Runtime、Compiler、Linker均由Go编写,实现自举。只需要安装了上一个版本,即可从源码安装。 |
|||
|
|||
在Go 1.5前,Go的源代码中,有些部分是用Plan 9 C和AT&T汇编写的,因此假如你要想从源码安装,就必须安装C的编译工具。 |
|||
|
|||
在Mac系统中,只要你安装了Xcode,就已经包含了相应的编译工具。 |
|||
|
|||
在类Unix系统中,需要安装gcc等工具。例如Ubuntu系统可通过在终端中执行`sudo apt-get install gcc libc6-dev`来安装编译工具。 |
|||
|
|||
在 Windows 系统中,你需要安装 MinGW,然后通过 MinGW 安装 gcc,并设置相应的环境变量。 |
|||
|
|||
你可以直接去官网[下载源码](http://golang.org/dl/),找相应的`goVERSION.src.tar.gz`的文件下载,下载之后解压缩到`$HOME`目录,执行如下代码: |
|||
|
|||
cd go/src |
|||
./all.bash |
|||
|
|||
运行all.bash后出现"ALL TESTS PASSED"字样时才算安装成功。 |
|||
|
|||
上面是Unix风格的命令,Windows下的安装方式类似,只不过是运行`all.bat`,调用的编译器是MinGW的gcc。 |
|||
|
|||
如果是Mac或者Unix用户需要设置几个环境变量,如果想重启之后也能生效的话把下面的命令写到`.bashrc`或者`.zshrc`里面, |
|||
|
|||
export GOPATH=$HOME/gopath |
|||
export PATH=$PATH:$HOME/go/bin:$GOPATH/bin |
|||
|
|||
如果你是写入文件的,记得执行`bash .bashrc`或者`bash .zshrc`使得设置立马生效。 |
|||
|
|||
如果是window系统,就需要设置环境变量,在path里面增加相应的go所在的目录,设置gopath变量。 |
|||
|
|||
当你设置完毕之后在命令行里面输入`go`,看到如下图片即说明你已经安装成功 |
|||
|
|||
![](images/1.1.mac.png?raw=true) |
|||
|
|||
图1.1 源码安装之后执行Go命令的图 |
|||
|
|||
如果出现Go的Usage信息,那么说明Go已经安装成功了;如果出现该命令不存在,那么可以检查一下自己的PATH环境变中是否包含了Go的安装目录。 |
|||
|
|||
从go 1.8开始,GOPATH 环境变量现在有一个默认值,如果它没有被设置。 它在Unix上默认为$HOME/go,在Windows上默认为%USERPROFILE%/go。 |
|||
从 Go1.11 开始, Go 官方加入了 Go Module 支持. |
|||
> 关于上面的 GO Module 和 GOPATH 将在下面小节详细讲解 |
|||
|
|||
|
|||
## links |
|||
* [目录](<preface.md>) |
|||
* 上一节: [Go环境配置](<01.0.md>) |
|||
* 下一节: [Go Module, GOPATH 与工作空间](<01.2.md>) |
|||
|
|||
[downlink]:http://golang.org/dl/ "Go安装包下载" |
@ -0,0 +1,204 @@ |
|||
# 1.3 Go 命令 |
|||
|
|||
## Go 命令 |
|||
|
|||
Go语言自带有一套完整的命令操作工具,你可以通过在命令行中执行`go`来查看它们: |
|||
|
|||
![](images/1.1.mac.png?raw=true) |
|||
|
|||
图1.3 Go命令显示详细的信息 |
|||
|
|||
这些命令对于我们平时编写的代码非常有用,接下来就让我们了解一些常用的命令。 |
|||
|
|||
## go build |
|||
|
|||
这个命令主要用于编译代码。在包的编译过程中,若有必要,会同时编译与之相关联的包。 |
|||
|
|||
- 如果是普通包,就像我们在1.2节中编写的`mymath`包那样,当你执行`go build`之后,它不会产生任何文件。如果你需要在`$GOPATH/pkg`下生成相应的文件,那就得执行`go install`。 |
|||
|
|||
- 如果是`main`包,当你执行`go build`之后,它就会在当前目录下生成一个可执行文件。如果你需要在`$GOPATH/bin`下生成相应的文件,需要执行`go install`,或者使用`go build -o 路径/a.exe`。 |
|||
|
|||
- 如果某个项目文件夹下有多个文件,而你只想编译某个文件,就可在`go build`之后加上文件名,例如`go build a.go`;`go build`命令默认会编译当前目录下的所有go文件。 |
|||
|
|||
- 你也可以指定编译输出的文件名。例如1.2节中的`mathapp`应用,我们可以指定`go build -o astaxie.exe`,默认情况是你的package名(非main包),或者是第一个源文件的文件名(main包)。 |
|||
|
|||
(注:实际上,package名在[Go语言规范](https://golang.org/ref/spec)中指代码中“package”后使用的名称,此名称可以与文件夹名不同。默认生成的可执行文件名是文件夹名。) |
|||
|
|||
- go build会忽略目录下以“_”或“.”开头的go文件。 |
|||
|
|||
- 如果你的源代码针对不同的操作系统需要不同的处理,那么你可以根据不同的操作系统后缀来命名文件。例如有一个读取数组的程序,它对于不同的操作系统可能有如下几个源文件: |
|||
|
|||
array_linux.go |
|||
array_darwin.go |
|||
array_windows.go |
|||
array_freebsd.go |
|||
|
|||
`go build`的时候会选择性地编译以系统名结尾的文件(Linux、Darwin、Windows、Freebsd)。例如Linux系统下面编译只会选择array_linux.go文件,其它系统命名后缀文件全部忽略。 |
|||
|
|||
参数的介绍 |
|||
|
|||
- `-o` 指定输出的文件名,可以带上路径,例如 `go build -o a/b/c` |
|||
- `-i` 安装相应的包,编译+`go install` |
|||
- `-a` 更新全部已经是最新的包的,但是对标准包不适用 |
|||
- `-n` 把需要执行的编译命令打印出来,但是不执行,这样就可以很容易的知道底层是如何运行的 |
|||
- `-p n` 指定可以并行可运行的编译数目,默认是CPU数目 |
|||
- `-race` 开启编译的时候自动检测数据竞争的情况,目前只支持64位的机器 |
|||
- `-v` 打印出来我们正在编译的包名 |
|||
- `-work` 打印出来编译时候的临时文件夹名称,并且如果已经存在的话就不要删除 |
|||
- `-x` 打印出来执行的命令,其实就是和`-n`的结果类似,只是这个会执行 |
|||
- `-ccflags 'arg list'` 传递参数给5c, 6c, 8c 调用 |
|||
- `-compiler name` 指定相应的编译器,gccgo还是gc |
|||
- `-gccgoflags 'arg list'` 传递参数给gccgo编译连接调用 |
|||
- `-gcflags 'arg list'` 传递参数给5g, 6g, 8g 调用 |
|||
- `-installsuffix suffix` 为了和默认的安装包区别开来,采用这个前缀来重新安装那些依赖的包,`-race`的时候默认已经是`-installsuffix race`,大家可以通过`-n`命令来验证 |
|||
- `-ldflags 'flag list'` 传递参数给5l, 6l, 8l 调用 |
|||
- `-tags 'tag list'` 设置在编译的时候可以适配的那些tag,详细的tag限制参考里面的 [Build Constraints](http://golang.org/pkg/go/build/) |
|||
|
|||
## go clean |
|||
|
|||
这个命令是用来移除当前源码包和关联源码包里面编译生成的文件。这些文件包括 |
|||
|
|||
_obj/ 旧的object目录,由Makefiles遗留 |
|||
_test/ 旧的test目录,由Makefiles遗留 |
|||
_testmain.go 旧的gotest文件,由Makefiles遗留 |
|||
test.out 旧的test记录,由Makefiles遗留 |
|||
build.out 旧的test记录,由Makefiles遗留 |
|||
*.[568ao] object文件,由Makefiles遗留 |
|||
|
|||
DIR(.exe) 由go build产生 |
|||
DIR.test(.exe) 由go test -c产生 |
|||
MAINFILE(.exe) 由go build MAINFILE.go产生 |
|||
*.so 由 SWIG 产生 |
|||
|
|||
我一般都是利用这个命令清除编译文件,然后GitHub递交源码,在本机测试的时候这些编译文件都是和系统相关的,但是对于源码管理来说没必要。 |
|||
|
|||
$ go clean -i -n |
|||
cd /Users/astaxie/develop/gopath/src/mathapp |
|||
rm -f mathapp mathapp.exe mathapp.test mathapp.test.exe app app.exe |
|||
rm -f /Users/astaxie/develop/gopath/bin/mathapp |
|||
|
|||
参数介绍 |
|||
|
|||
- `-i` 清除关联的安装的包和可运行文件,也就是通过go install安装的文件 |
|||
- `-n` 把需要执行的清除命令打印出来,但是不执行,这样就可以很容易的知道底层是如何运行的 |
|||
- `-r` 循环的清除在import中引入的包 |
|||
- `-x` 打印出来执行的详细命令,其实就是`-n`打印的执行版本 |
|||
|
|||
## go fmt |
|||
|
|||
有过C/C++经验的读者会知道,一些人经常为代码采取K&R风格还是ANSI风格而争论不休。在go中,代码则有标准的风格。由于之前已经有的一些习惯或其它的原因我们常将代码写成ANSI风格或者其它更合适自己的格式,这将为人们在阅读别人的代码时添加不必要的负担,所以go强制了代码格式(比如左大括号必须放在行尾),不按照此格式的代码将不能编译通过,为了减少浪费在排版上的时间,go工具集中提供了一个`go fmt`命令 它可以帮你格式化你写好的代码文件,使你写代码的时候不需要关心格式,你只需要在写完之后执行`go fmt <文件名>.go`,你的代码就被修改成了标准格式,但是我平常很少用到这个命令,因为开发工具里面一般都带了保存时候自动格式化功能,这个功能其实在底层就是调用了`go fmt`。接下来的一节我将讲述两个工具,这两个工具都自带了保存文件时自动化`go fmt`功能。 |
|||
|
|||
使用go fmt命令,其实是调用了gofmt,而且需要参数-w,否则格式化结果不会写入文件。gofmt -w -l src,可以格式化整个项目。 |
|||
|
|||
所以go fmt是gofmt的上层一个包装的命令,我们想要更多的个性化的格式化可以参考 [gofmt](http://golang.org/cmd/gofmt/) |
|||
|
|||
gofmt的参数介绍 |
|||
|
|||
- `-l` 显示那些需要格式化的文件 |
|||
- `-w` 把改写后的内容直接写入到文件中,而不是作为结果打印到标准输出。 |
|||
- `-r` 添加形如“a[b:len(a)] -> a[b:]”的重写规则,方便我们做批量替换 |
|||
- `-s` 简化文件中的代码 |
|||
- `-d` 显示格式化前后的diff而不是写入文件,默认是false |
|||
- `-e` 打印所有的语法错误到标准输出。如果不使用此标记,则只会打印不同行的前10个错误。 |
|||
- `-cpuprofile` 支持调试模式,写入相应的cpufile到指定的文件 |
|||
|
|||
## go get |
|||
|
|||
这个命令是用来动态获取远程代码包的,目前支持的有BitBucket、GitHub、Google Code和Launchpad。这个命令在内部实际上分成了两步操作:第一步是下载源码包,第二步是执行`go install`。下载源码包的go工具会自动根据不同的域名调用不同的源码工具,对应关系如下: |
|||
|
|||
BitBucket (Mercurial Git) |
|||
GitHub (Git) |
|||
Google Code Project Hosting (Git, Mercurial, Subversion) |
|||
Launchpad (Bazaar) |
|||
|
|||
所以为了`go get` 能正常工作,你必须确保安装了合适的源码管理工具,并同时把这些命令加入你的PATH中。其实`go get`支持自定义域名的功能,具体参见`go help remote`。 |
|||
|
|||
参数介绍: |
|||
|
|||
- `-d` 只下载不安装 |
|||
- `-f` 只有在你包含了`-u`参数的时候才有效,不让`-u`去验证import中的每一个都已经获取了,这对于本地fork的包特别有用 |
|||
- `-fix` 在获取源码之后先运行fix,然后再去做其他的事情 |
|||
- `-t` 同时也下载需要为运行测试所需要的包 |
|||
- `-u` 强制使用网络去更新包和它的依赖包 |
|||
- `-v` 显示执行的命令 |
|||
|
|||
## go install |
|||
|
|||
这个命令在内部实际上分成了两步操作:第一步是生成结果文件(可执行文件或者.a包),第二步会把编译好的结果移到`$GOPATH/pkg`或者`$GOPATH/bin`。 |
|||
|
|||
参数支持`go build`的编译参数。大家只要记住一个参数`-v`就好了,这个随时随地的可以查看底层的执行信息。 |
|||
|
|||
## go test |
|||
|
|||
执行这个命令,会自动读取源码目录下面名为`*_test.go`的文件,生成并运行测试用的可执行文件。输出的信息类似 |
|||
|
|||
ok archive/tar 0.011s |
|||
FAIL archive/zip 0.022s |
|||
ok compress/gzip 0.033s |
|||
... |
|||
|
|||
默认的情况下,不需要任何的参数,它会自动把你源码包下面所有test文件测试完毕,当然你也可以带上参数,详情请参考`go help testflag` |
|||
|
|||
这里我介绍几个我们常用的参数: |
|||
|
|||
- `-bench regexp` 执行相应的benchmarks,例如 `-bench=.` |
|||
- `-cover` 开启测试覆盖率 |
|||
- `-run regexp` 只运行regexp匹配的函数,例如 `-run=Array` 那么就执行包含有Array开头的函数 |
|||
- `-v` 显示测试的详细命令 |
|||
|
|||
## go tool |
|||
`go tool`下面下载聚集了很多命令,这里我们只介绍两个,fix和vet |
|||
|
|||
- `go tool fix .` 用来修复以前老版本的代码到新版本,例如go1之前老版本的代码转化到go1,例如API的变化 |
|||
- `go tool vet directory|files` 用来分析当前目录的代码是否都是正确的代码,例如是不是调用fmt.Printf里面的参数不正确,例如函数里面提前return了然后出现了无用代码之类的。 |
|||
|
|||
## go generate |
|||
这个命令是从Go1.4开始才设计的,用于在编译前自动化生成某类代码。`go generate`和`go build`是完全不一样的命令,通过分析源码中特殊的注释,然后执行相应的命令。这些命令都是很明确的,没有任何的依赖在里面。而且大家在用这个之前心里面一定要有一个理念,这个`go generate`是给你用的,不是给使用你这个包的人用的,是方便你来生成一些代码的。 |
|||
|
|||
这里我们来举一个简单的例子,例如我们经常会使用`yacc`来生成代码,那么我们常用这样的命令: |
|||
|
|||
go tool yacc -o gopher.go -p parser gopher.y |
|||
|
|||
-o 指定了输出的文件名, -p指定了package的名称,这是一个单独的命令,如果我们想让`go generate`来触发这个命令,那么就可以在当前目录的任意一个`xxx.go`文件里面的任意位置增加一行如下的注释: |
|||
|
|||
//go:generate go tool yacc -o gopher.go -p parser gopher.y |
|||
|
|||
这里我们注意了,`//go:generate`是没有任何空格的,这其实就是一个固定的格式,在扫描源码文件的时候就是根据这个来判断的。 |
|||
|
|||
所以我们可以通过如下的命令来生成,编译,测试。如果`gopher.y`文件有修改,那么就重新执行`go generate`重新生成文件就好。 |
|||
|
|||
$ go generate |
|||
$ go build |
|||
$ go test |
|||
|
|||
|
|||
## godoc |
|||
|
|||
在Go1.2版本之前还支持`go doc`命令,但是之后全部移到了godoc这个命令下,需要这样安装`go get golang.org/x/tools/cmd/godoc` |
|||
|
|||
很多人说go不需要任何的第三方文档,例如chm手册之类的(其实我已经做了一个了,[chm手册](https://github.com/astaxie/godoc)),因为它内部就有一个很强大的文档工具。 |
|||
|
|||
如何查看相应package的文档呢? |
|||
例如builtin包,那么执行`godoc builtin` |
|||
如果是http包,那么执行`godoc net/http` |
|||
查看某一个包里面的函数,那么执行`godoc fmt Printf` |
|||
也可以查看相应的代码,执行`godoc -src fmt Printf` |
|||
|
|||
通过命令在命令行执行 godoc -http=:端口号 比如`godoc -http=:8080`。然后在浏览器中打开`127.0.0.1:8080`,你将会看到一个golang.org的本地copy版本,通过它你可以查询pkg文档等其它内容。如果你设置了GOPATH,在pkg分类下,不但会列出标准包的文档,还会列出你本地`GOPATH`中所有项目的相关文档,这对于经常被墙的用户来说是一个不错的选择。 |
|||
|
|||
## 其它命令 |
|||
|
|||
go还提供了其它很多的工具,例如下面的这些工具 |
|||
|
|||
go version 查看go当前的版本 |
|||
go env 查看当前go的环境变量 |
|||
go list 列出当前全部安装的package |
|||
go run 编译并运行Go程序 |
|||
|
|||
以上这些工具还有很多参数没有一一介绍,用户可以使用`go help 命令`获取更详细的帮助信息。 |
|||
|
|||
|
|||
## links |
|||
* [目录](<preface.md>) |
|||
* 上一节: [Go Module, GOPATH与工作空间](<01.2.md>) |
|||
* 下一节: [Go开发工具](<01.4.md>) |
@ -0,0 +1,8 @@ |
|||
# 1.5 总结 |
|||
|
|||
这一章中我们主要介绍了如何安装Go,Go可以通过三种方式安装:源码安装、标准包安装、第三方工具安装,安装之后我们需要配置我们的开发环境,然后介绍了如何配置本地的`$GOPATH`,通过设置`$GOPATH`之后读者就可以创建项目,接着介绍了如何来进行项目编译、应用安装等问题,这些需要用到很多Go命令,所以接着就介绍了一些Go的常用命令工具,包括编译、安装、格式化、测试等命令,最后介绍了Go的开发工具,目前有很多Go的开发工具:LiteIDE、Sublime、VSCode、Atom、Goland、VIM、Emacs、Eclipse、Idea等工具,读者可以根据自己熟悉的工具进行配置,希望能够通过方便的工具快速的开发Go应用。 |
|||
|
|||
## links |
|||
* [目录](<preface.md>) |
|||
* 上一节: [Go开发工具](<01.4.md>) |
|||
* 下一章: [Go语言基础](<02.0.md>) |
After Width: | Height: | Size: 66 KiB |
After Width: | Height: | Size: 79 KiB |
After Width: | Height: | Size: 123 KiB |
After Width: | Height: | Size: 40 KiB |
After Width: | Height: | Size: 134 KiB |
After Width: | Height: | Size: 55 KiB |
After Width: | Height: | Size: 8.4 KiB |
After Width: | Height: | Size: 82 KiB |
After Width: | Height: | Size: 23 KiB |
After Width: | Height: | Size: 14 KiB |
@ -0,0 +1,7 @@ |
|||
package main |
|||
|
|||
import "fmt" |
|||
|
|||
func main() { |
|||
fmt.Println("12") |
|||
} |
@ -0,0 +1,39 @@ |
|||
package main |
|||
|
|||
import ( |
|||
"encoding/hex" |
|||
"fmt" |
|||
) |
|||
|
|||
func main() { |
|||
fmt.Println("\n ================== 基础类型 = 开始 ================== ") |
|||
|
|||
boolvar := true |
|||
fmt.Println("布尔\t boolvar = ", boolvar) |
|||
|
|||
var intvar int |
|||
fmt.Println("整形\t intvar = ", intvar) |
|||
|
|||
var float32var float32 |
|||
fmt.Println("浮点型\t float32var = ", float32var) |
|||
|
|||
var bytevar byte |
|||
bytevar = 'a' |
|||
fmt.Println("字符\t bytevar = ", bytevar) |
|||
|
|||
var int32 byte |
|||
int32 = 0x31 |
|||
//int32 = int32+1
|
|||
fmt.Println("16进制数值\t int32 = ", int32) |
|||
|
|||
// 注意"Hello"与"encodedStr"不相等,encodedStr是用字符串来表示16进制
|
|||
src := []byte("Hello") |
|||
// [72 101 108 108 111]
|
|||
fmt.Println("16进制Hex\t src = ", src) |
|||
// 48656c6c6f -> 48(4*16+8=72) 65(6*16+5=101) 6c 6c 6f
|
|||
encodedStr := hex.EncodeToString(src) |
|||
fmt.Println("16进制Hex\t encodedStr = ", encodedStr) |
|||
|
|||
intcodedStr := hex.EncodeToString([]byte("192.168.1.123")) |
|||
fmt.Println("16进制Hex\t intcodedStr = ", intcodedStr) |
|||
} |