1- # 1.3 GO 命令
1+ # 1.3 Go 命令
22
3- ##GO 命令
3+ ##Go 命令
44
5- go语言自带有一套完整的命令操作工具，你可以在你的命令行下面输入 ` go ` ，就会出现如下的一些信息
5+ Go语言自带有一套完整的命令操作工具，你可以通过在命令行中执行 ` go ` 来查看它们：
66
77 ![ ] ( images/1.3.go.png?raw=true )
88
9- 这些命令对于我们平时编写的代码非常有用，接下来我将就平常用到比较多的几个命令进行简要的讲解
9+ 这些命令对于我们平时编写的代码非常有用，接下来就让我们了解一些常用的命令。
1010
1111##go build
1212
13- 这个命令主要是用来测试编译的，在包编译过程中，若有必要会同时去编译相应的关联包
13+ 这个命令主要用于测试编译。在包的编译过程中，若有必要，会同时编译与之相关联的包。
1414
15- - 如果是pkg包，例如第一章里面写的mymath包，你执行` go build ` 的时候，不会产生任何的文件，因为他不会默认帮你去安装，如果你需要在pkg下面生成相应的文件，那么就需要执行` go install `
16- - 如果你的程序是main包，那么就会在你的目录下面生成一个可执行文件，但是不会生成文件到bin目录下面
15+ - 如果是普通包，就像我们在1.2节中编写的` mymath ` 包那样，当你执行` go build ` 之后，它不会产生任何文件。如果你需要在` $GOPATH/pkg ` 下生成相应的文件，那就得执行` go install ` 了。
1716
18- 如果某个项目文件夹下有多个文件，又只想指定编译某个文件，这个命令可以指定编译文件，例如 ` go build a.go ` , ` go build ` 命令默认编译目录下全部的go文件
17+ - 如果是 ` main ` 包，当你执行 ` go build ` 之后，它就会在当前目录下生成一个可执行文件。如果你需要在 ` $GOPATH/bin ` 下生成相应的文件，同样需要执行 ` go install ` 。
1918
20- 你也可以指定编译输出文件的名称，例如第一章的那个mathapp应用，我可以指定` go build -o astaxie.exe ` ,默认情况是你的package名，就是你的文件夹名称
21-
22- （注：实际上，package名在[ go语言规范] ( https://golang.org/ref/spec ) 中指代码中“package”后使用的名称，此名称可以与文件夹名不同。默认生成的可执行文件名是文件夹名。）
23-
24- go build会忽略目录下以”_ “开头的go文件,还会忽略点开头的的go文件。
19+ - 如果某个项目文件夹下有多个文件，而你只想编译某个文件，就可在` go build ` 之后加上文件名，例如` go build a.go ` ；` go build ` 命令默认会编译当前目录下的所有go文件。
2520
26- 如果你的源代码里面针对不同系统需要不同的逻辑处理，那么你可以根据不同的系统来命名文件，例如有一个读取数组的文件在不同的系统可能有如下几个文件
21+ - 你也可以指定编译输出的文件名。例如1.2节中的 ` mathapp ` 应用，我们可以指定 ` go build -o astaxie.exe ` ，默认情况是你的package名，就是你的文件夹名称。
2722
28- array_linux.go
29- array_darwin.go
30- array_windows.go
31- array_freebsd.go
23+ （注：实际上，package名在[ Go语言规范] ( https://golang.org/ref/spec ) 中指代码中“package”后使用的名称，此名称可以与文件夹名不同。默认生成的可执行文件名是文件夹名。）
3224
33- go build的时候会选择性的编译系统名结尾的文件(linux、darwin、windows、freebsd)，例如linux系统下面编译只会选择array_linux.go文件，其他系统命名后缀文件全部忽略。
25+ - go build会忽略目录下以“_ ”或“.”开头的go文件。
26+
27+ - 如果你的源代码针对不同的操作系统需要不同的处理，那么你可以根据不同的操作系统后缀来命名文件。例如有一个读取数组的程序，它对于不同的操作系统可能有如下几个源文件：
28+
29+ array_linux.go
30+ array_darwin.go
31+ array_windows.go
32+ array_freebsd.go
33+
34+ ` go build ` 的时候会选择性地编译以系统名结尾的文件（linux、darwin、windows、freebsd）。例如Linux系统下面编译只会选择array_linux.go文件，其它系统命名后缀文件全部忽略。
3435
3536##go clean
3637
37- 这个命令是用来移除当前源码包里面编译的文件的， 这些文件包括
38-
39- _obj/ old object directory, left from Makefiles
40- _test/ old test directory, left from Makefiles
41- _testmain.go old gotest file, left from Makefiles
42- test.out old test log, left from Makefiles
43- build.out old test log, left from Makefiles
44- *.[568ao] object files, left from Makefiles
45-
46- DIR(.exe) from go build
47- DIR.test(.exe) from go test -c
48- MAINFILE(.exe) from go build MAINFILE.go
38+ 这个命令是用来移除当前源码包里面编译的文件的。 这些文件包括
39+
40+ _obj/ 旧的object目录，由Makefiles遗留
41+ _test/ 旧的test目录，由Makefiles遗留
42+ _testmain.go 旧的gotest文件，由Makefiles遗留
43+ test.out 旧的test记录，由Makefiles遗留
44+ build.out 旧的test记录，由Makefiles遗留
45+ *.[568ao] object文件，由Makefiles遗留
46+
47+ DIR(.exe) 由go build产生
48+ DIR.test(.exe) 由go test -c产生
49+ MAINFILE(.exe) 由go build MAINFILE.go产生
4950
5051 我一般都是利用这个命令进行清除编译文件，然后github递交源码，在本机测试的时候这些编译文件都是和系统相关的，但是对于源码管理来说没必要
5152
5253##go fmt
5354
54- 有过c/c ++经验的读者会知道,一些人经常为代码采取k&r风格还是 ansi风格而争论不休, 在go中,代码有标准风格.由于之前已经有的一些习惯或其他的原因我们常将代码写成ansi风格或者其他更合适自己的格式， 这将为人们在阅读别人的代码时添加不必要的负担，所以go强制了代码格式（ 比如左大括号必须放在行尾），不按照此格式的代码将不能编译通过，为了减少浪费在排版上的时间，go工具集中提供了一个 go fmt命令 它可以帮你格式化你写好的代码文件，使你写代码的时候不需要关心格式，你只需要在写完之后执行`go fmt 文件名.go`，你的代码就被修改成了标准格式，但是我平常很少用到这个命令，因为开发工具里面一般都带了保存时候自动格式化功能，这个功能其实在底层就是调用了`go fmt`。接下来的一节我将讲述两个工具，这两个工具都自带了保存文件自动化 `go fmt`功能。
55+ 有过C/C ++经验的读者会知道,一些人经常为代码采取K&R风格还是ANSI风格而争论不休。 在go中，代码则有标准的风格。由于之前已经有的一些习惯或其它的原因我们常将代码写成ANSI风格或者其它更合适自己的格式， 这将为人们在阅读别人的代码时添加不必要的负担，所以go强制了代码格式（比如左大括号必须放在行尾），不按照此格式的代码将不能编译通过，为了减少浪费在排版上的时间，go工具集中提供了一个` go fmt`命令 它可以帮你格式化你写好的代码文件，使你写代码的时候不需要关心格式，你只需要在写完之后执行`go fmt < 文件名> .go`，你的代码就被修改成了标准格式，但是我平常很少用到这个命令，因为开发工具里面一般都带了保存时候自动格式化功能，这个功能其实在底层就是调用了`go fmt`。接下来的一节我将讲述两个工具，这两个工具都自带了保存文件时自动化 `go fmt`功能。
5556
5657##go get
5758
58- 这个命令是用来动态获取远程代码包的，目前支持的有BitBucket、GitHub、Google Code 、Launchpad ， 这个命令在内部实际上分成了两步操作， 第一步是下载源码包，第二步是 ` go install ` ，下载源码包go工具会自动根据不同的域名调用不同的源码工具 ，对应关系如下：
59+ 这个命令是用来动态获取远程代码包的，目前支持的有BitBucket、GitHub、Google Code和Launchpad。 这个命令在内部实际上分成了两步操作： 第一步是下载源码包，第二步是执行 ` go install ` 。下载源码包的go工具会自动根据不同的域名调用不同的源码工具 ，对应关系如下：
5960
6061 BitBucket (Mercurial Git)
6162 GitHub (Git)
6263 Google Code Project Hosting (Git, Mercurial, Subversion)
6364 Launchpad (Bazaar)
6465
65- 所以为了` go get ` 能正常工作，你必须确保安装了合适的 源码管理工具同时把这些命令加入你的path 。其实` go get ` 支持自定义域名的功能，具体参见` go help remote `
66+ 所以为了` go get ` 能正常工作，你必须确保安装了合适的源码管理工具，并同时把这些命令加入你的PATH中 。其实` go get ` 支持自定义域名的功能，具体参见` go help remote ` 。
6667
6768##go install
6869
69- 这个命令在内部实际上分成了两步操作，第一步就是 ` go build ` ，然后就是把编译的东西copy到了pkg或者bin
70+ 这个命令在内部实际上分成了两步操作：第一步是 ` go build ` ，第二步会把编译好的东西copy到 ` $GOPATH/pkg ` 或者 ` $GOPATH/bin ` 。
7071
7172##go test
7273
73- 执行这个命令，会自动读取源码目录下面命名为 ` *_test.go ` 的文件，生成并运行测试用的可执行文件。输出的信息类似
74+ 执行这个命令，会自动读取源码目录下面名为 ` *_test.go ` 的文件，生成并运行测试用的可执行文件。输出的信息类似
7475
7576 ok archive/tar 0.011s
7677 FAIL archive/zip 0.022s
7778 ok compress/gzip 0.033s
7879 ...
7980
80- 默认的情况下，不需要任何的参数，他会自动把你源码包下面所有test文件测试完毕 ，当然你也可以带上参数，详细的参考 ` go help testflag `
81+ 默认的情况下，不需要任何的参数，它会自动把你源码包下面所有test文件测试完毕 ，当然你也可以带上参数，详情请参考 ` go help testflag `
8182
8283##go doc
8384
84- 很多人说go不需要任何的第三方文档，例如chm手册之类的( 其实我已经做了一个了，[ chm手册] ( https://github.com/astaxie/godoc ) )，因为他内部就有一个很强大的文档工具
85-
85+ 很多人说go不需要任何的第三方文档，例如chm手册之类的（ 其实我已经做了一个了，[ chm手册] ( https://github.com/astaxie/godoc ) ），因为它内部就有一个很强大的文档工具。
86+
8687 如何查看相应package的文档呢？
8788 例如builtin包，那么执行`go doc builtin`
8889 如果是http包，那么执行`go doc net/http`
8990 查看某一个包里面的函数，那么执行`godoc fmt Printf`
9091 也可以查看相应的代码，执行`godoc -src fmt Printf`
91-
92- 通过命令在命令行执行 godoc -http=:端口号 比如( godoc -http=:8080).然后在浏览器中打开 127.0.0.1:8080 你将会看到一个 golang.org的本地copy版本,通过它你可以查询pkg文档等其他内容，如果你设置了GOPATH,在pkg分类下,不但会列出标准包的文档，还会列出你本地GOPATH中所有项目的相关文档,这对于经常被墙奸的用户来说,是一个不错的选择
9392
94- ##其他命令
93+ 通过命令在命令行执行 godoc -http=:端口号 比如` godoc -http=:8080 ` 。然后在浏览器中打开` 127.0.0.1:8080 ` ，你将会看到一个golang.org的本地copy版本，通过它你可以查询pkg文档等其它内容。如果你设置了GOPATH，在pkg分类下，不但会列出标准包的文档，还会列出你本地` GOPATH ` 中所有项目的相关文档，这对于经常被墙的用户来说是一个不错的选择。
94+
95+ ##其它命令
9596
96- go还提供了其他很多的工具 ，例如下面的这些工具
97+ go还提供了其它很多的工具 ，例如下面的这些工具
9798
9899 go fix 用来修复以前老版本的代码到新版本，例如go1之前老版本的代码转化到go1
99100 go version 查看go当前的版本
@@ -104,7 +105,7 @@ go build的时候会选择性的编译系统名结尾的文件(linux、darwin、
104105## links
105106 * [ 目录] ( < preface.md > )
106107 * 上一节: [ GOPATH与工作空间] ( < 1.2.md > )
107- * 下一节: [ GO开发工具 ] ( < 1.4.md > )
108+ * 下一节: [ Go开发工具 ] ( < 1.4.md > )
108109
109- ## LastModified
110+ ## LastModified
110111 * $Id$
0 commit comments