# 1.3 GO Shell 命令

##GO 命令

  go语言自带有一套完整的命令操作工具，你可以在你的命令行下面输入`go`，就会出现如下的一些信息

  ![](images/1.3.go.png?raw=true)

  这些命令对于我们平时编写的代码非常有用，接下来我将就平常用到比较多的几个命令进行简要的讲解

##go build

  这个命令主要是用来测试编译的，在包编译过程中，若有必要会同时去编译相应的关联包

  - 如果是pkg包，例如第一章里面写的mymath包，你执行`go build`的时候，不会产生任何的文件，因为他不会默认帮你去安装，如果你需要在pkg下面生成相应的文件，那么就需要执行`go install`
  - 如果你的程序是main包，那么就会在你的目录下面生成一个可执行文件，但是不会生成文件到bin目录下面

  如果某个项目文件夹下有多个文件，又只想指定编译某个文件，这个命令可以指定编译文件，例如`go build a.go`,`go build`命令默认编译目录下全部的go文件

  你也可以指定编译输出文件的名称，例如第一章的那个mathapp应用，我可以指定`go build -o astaxie.exe`,默认情况是你的package名，就是你的文件夹名称
  
  （注：实际上，package名在[go语言规范](https://golang.org/ref/spec)中指代码中“package”后使用的名称，此名称可以与文件夹名不同。默认生成的可执行文件名是文件夹名。）
  
  go build会忽略目录下以”_“开头的go文件

  go build会选择性的编译系统名结尾的文件(linux、darwin、windows、freebsd),如果你编写的代码用了类似的名字结尾，那么很可能在别的系统下无法编译通过。

##go clean

  这个命令是用来移除当前源码包里面编译的文件的，这些文件包括
  	
	_obj/            old object directory, left from Makefiles
	_test/           old test directory, left from Makefiles
	_testmain.go     old gotest file, left from Makefiles
	test.out         old test log, left from Makefiles
	build.out        old test log, left from Makefiles
	*.[568ao]        object files, left from Makefiles
	
	DIR(.exe)        from go build
	DIR.test(.exe)   from go test -c
	MAINFILE(.exe)   from go build MAINFILE.go

  我一般都是利用这个命令进行清除编译文件，然后github递交源码，在本机测试的时候这些编译文件都是和系统相关的，但是对于源码管理来说没必要

##go fmt

  有过c/c++经验的读者会知道,一些人经常为代码采取k&r风格还是 ansi风格而争论不休,在go中,代码有标准风格.由于之前已经有的一些习惯或其他的原因我们常将代码写成ansi风格或者其他更合适自己的格式，这将为人们在阅读别人的代码时添加不必要的负担，所以go强制了代码格式（ 比如左大括号必须放在行尾），不按照此格式的代码将不能编译通过，为了减少浪费在排版上的时间，go工具集中提供了一个 go fmt命令 它可以帮你格式化你写好的代码文件，使你写代码的时候不需要关心格式，你只需要在写完之后执行`go fmt 文件名.go`，你的代码就被修改成了标准格式，但是我平常很少用到这个命令，因为开发工具里面一般都带了保存时候自动格式化功能，这个功能其实在底层就是调用了`go fmt`。接下来的一节我将讲述两个工具，这两个工具都自带了保存文件自动化`go fmt`功能。

##go get

  这个命令是用来动态获取远程代码包的，目前支持的有BitBucket、GitHub、Google Code 、Launchpad ，这个命令在内部实际上分成了两步操作，第一步是下载源码包，第二步是`go install`，下载源码包go工具会自动根据不同的域名调用不同的源码工具，对应关系如下：

	BitBucket (Mercurial)
	GitHub (Git)
	Google Code Project Hosting (Git, Mercurial, Subversion)
	Launchpad (Bazaar)

 所以为了`go get` 能正常工作，你必须确保安装了合适的 源码管理工具同时把这些命令加入你的path

##go install

  这个命令在内部实际上分成了两步操作，第一步就是`go build`，然后就是把编译的东西copy到了pkg或者bin

##go test

  执行这个命令，会自动读取源码目录下面命名为`*_test.go`的文件，生成并运行测试用的可执行文件。输出的信息类似

	ok   archive/tar   0.011s
	FAIL archive/zip   0.022s
	ok   compress/gzip 0.033s
	...

  默认的情况下，不需要任何的参数，他会自动把你源码包下面所有test文件测试完毕，当然你也可以带上参数，详细的参考`go help testflag`

##go doc

  很多人说go不需要任何的第三方文档，例如chm手册之类的(其实我已经做了一个了，[chm手册](https://github.com/astaxie/godoc) )，因为他内部就有一个很强大的文档工具
     
    如何查看相应package的文档呢？
    例如builtin包，那么执行`go doc builtin`
    如果是http包，那么执行`go doc 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 fix 用来修复以前老版本的代码到新版本，例如go1之前老版本的代码转化到go1
	go version 查看go当前的版本
	go env 查看当前go的环境变量
	go list 列出当前全部安装的package
	go run 编译当前包并执行可执行文件

## links
   * [目录](<preface.md>)
   * 上一节: [GOPATH与工作空间](<1.2.md>)
   * 下一节: [GO开发工具](<1.4.md>)

## LastModified 
   * $Id$
