From 97fa89b9326648a53ff5a732e06a3163dd2c29e5 Mon Sep 17 00:00:00 2001 From: Oling Cat Date: Wed, 19 Sep 2012 18:40:31 +0800 Subject: [PATCH] Changed some sentence. --- 1.1.md | 14 ++++----- 1.3.md | 91 +++++++++++++++++++++++++++++----------------------------- 1.md | 1 + 3 files changed, 54 insertions(+), 52 deletions(-) diff --git a/1.1.md b/1.1.md index 7018ab2a..f3cb913f 100644 --- a/1.1.md +++ b/1.1.md @@ -65,7 +65,7 @@ Linux系统用户可通过在Terminal中执行命令`uname -a`来查看系统信 首先你必须安装了hg工具，然后执行如下代码： - 假设目前在当前用户的`home`目录下 + 假设目前在当前用户的`home`目录下 hg clone -u release https://code.google.com/p/go cd go/src @@ -75,20 +75,20 @@ Linux系统用户可通过在Terminal中执行命令`uname -a`来查看系统信 上面写的是Unix风格的，Windows下安装方式类似，只不过是运行all.bat，调用的编译器是MinGW的 gcc。 - 然后设置PATH，`export PATH=$PATH:$HOME/go/bin` + 然后设置PATH，`export PATH=$PATH:$HOME/go/bin` - 看到如下图片说明已经安装成功 + 看到如下图片说明已经安装成功 ![](images/1.1.mac.png?raw=true) 如果出现go的Usage信息，那么说明go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了go的安装目录。 ## links - * [目录]() - * 上一节: [Go环境配置](<1.md>) - * 下一节: [GOPATH 与工作空间](<1.2.md>) + * [目录]() + * 上一节: [Go环境配置](<1.md>) + * 下一节: [GOPATH 与工作空间](<1.2.md>) ## LastModified - * $Id$ + * $Id$ [downlink]: http://code.google.com/p/go/downloads/list "Go安装包下载" diff --git a/1.3.md b/1.3.md index fe573d94..0d13b1ce 100644 --- a/1.3.md +++ b/1.3.md @@ -1,99 +1,100 @@ -# 1.3 GO 命令 +# 1.3 Go 命令 -##GO 命令 +##Go 命令 - go语言自带有一套完整的命令操作工具，你可以在你的命令行下面输入`go`，就会出现如下的一些信息 + Go语言自带有一套完整的命令操作工具，你可以通过在命令行中执行`go`来查看它们： ![](images/1.3.go.png?raw=true) - 这些命令对于我们平时编写的代码非常有用，接下来我将就平常用到比较多的几个命令进行简要的讲解 + 这些命令对于我们平时编写的代码非常有用，接下来就让我们了解一些常用的命令。 ##go build - 这个命令主要是用来测试编译的，在包编译过程中，若有必要会同时去编译相应的关联包 + 这个命令主要用于测试编译。在包的编译过程中，若有必要，会同时编译与之相关联的包。 - - 如果是pkg包，例如第一章里面写的mymath包，你执行`go build`的时候，不会产生任何的文件，因为他不会默认帮你去安装，如果你需要在pkg下面生成相应的文件，那么就需要执行`go install` - - 如果你的程序是main包，那么就会在你的目录下面生成一个可执行文件，但是不会生成文件到bin目录下面 + - 如果是普通包，就像我们在1.2节中编写的`mymath`包那样，当你执行`go build`之后，它不会产生任何文件。如果你需要在`$GOPATH/pkg`下生成相应的文件，那就得执行`go install`了。 - 如果某个项目文件夹下有多个文件，又只想指定编译某个文件，这个命令可以指定编译文件，例如`go build a.go`,`go build`命令默认编译目录下全部的go文件 + - 如果是`main`包，当你执行`go build`之后，它就会在当前目录下生成一个可执行文件。如果你需要在`$GOPATH/bin`下生成相应的文件，同样需要执行`go install`。 - 你也可以指定编译输出文件的名称，例如第一章的那个mathapp应用，我可以指定`go build -o astaxie.exe`,默认情况是你的package名，就是你的文件夹名称 - - （注：实际上，package名在[go语言规范](https://golang.org/ref/spec)中指代码中“package”后使用的名称，此名称可以与文件夹名不同。默认生成的可执行文件名是文件夹名。） - - go build会忽略目录下以”_“开头的go文件,还会忽略点开头的的go文件。 + - 如果某个项目文件夹下有多个文件，而你只想编译某个文件，就可在`go build`之后加上文件名，例如`go build a.go`；`go build`命令默认会编译当前目录下的所有go文件。 - 如果你的源代码里面针对不同系统需要不同的逻辑处理，那么你可以根据不同的系统来命名文件，例如有一个读取数组的文件在不同的系统可能有如下几个文件 + - 你也可以指定编译输出的文件名。例如1.2节中的`mathapp`应用，我们可以指定`go build -o astaxie.exe`，默认情况是你的package名，就是你的文件夹名称。 - array_linux.go - array_darwin.go - array_windows.go - array_freebsd.go + （注：实际上，package名在[Go语言规范](https://golang.org/ref/spec)中指代码中“package”后使用的名称，此名称可以与文件夹名不同。默认生成的可执行文件名是文件夹名。） -go build的时候会选择性的编译系统名结尾的文件(linux、darwin、windows、freebsd)，例如linux系统下面编译只会选择array_linux.go文件，其他系统命名后缀文件全部忽略。 + - 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文件，其它系统命名后缀文件全部忽略。 ##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 + 这个命令是用来移除当前源码包里面编译的文件的。这些文件包括 + + _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产生 我一般都是利用这个命令进行清除编译文件，然后github递交源码，在本机测试的时候这些编译文件都是和系统相关的，但是对于源码管理来说没必要 ##go fmt - 有过c/c++经验的读者会知道,一些人经常为代码采取k&r风格还是 ansi风格而争论不休,在go中,代码有标准风格.由于之前已经有的一些习惯或其他的原因我们常将代码写成ansi风格或者其他更合适自己的格式，这将为人们在阅读别人的代码时添加不必要的负担，所以go强制了代码格式（ 比如左大括号必须放在行尾），不按照此格式的代码将不能编译通过，为了减少浪费在排版上的时间，go工具集中提供了一个 go fmt命令 它可以帮你格式化你写好的代码文件，使你写代码的时候不需要关心格式，你只需要在写完之后执行`go fmt 文件名.go`，你的代码就被修改成了标准格式，但是我平常很少用到这个命令，因为开发工具里面一般都带了保存时候自动格式化功能，这个功能其实在底层就是调用了`go fmt`。接下来的一节我将讲述两个工具，这两个工具都自带了保存文件自动化`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、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` + 所以为了`go get` 能正常工作，你必须确保安装了合适的源码管理工具，并同时把这些命令加入你的PATH中。其实`go get`支持自定义域名的功能，具体参见`go help remote`。 ##go install - 这个命令在内部实际上分成了两步操作，第一步就是`go build`，然后就是把编译的东西copy到了pkg或者bin + 这个命令在内部实际上分成了两步操作：第一步是`go build`，第二步会把编译好的东西copy到`$GOPATH/pkg`或者`$GOPATH/bin`。 ##go test - 执行这个命令，会自动读取源码目录下面命名为`*_test.go`的文件，生成并运行测试用的可执行文件。输出的信息类似 + 执行这个命令，会自动读取源码目录下面名为`*_test.go`的文件，生成并运行测试用的可执行文件。输出的信息类似 ok archive/tar 0.011s FAIL archive/zip 0.022s ok compress/gzip 0.033s ... - 默认的情况下，不需要任何的参数，他会自动把你源码包下面所有test文件测试完毕，当然你也可以带上参数，详细的参考`go help testflag` + 默认的情况下，不需要任何的参数，它会自动把你源码包下面所有test文件测试完毕，当然你也可以带上参数，详情请参考`go help testflag` ##go doc - 很多人说go不需要任何的第三方文档，例如chm手册之类的(其实我已经做了一个了，[chm手册](https://github.com/astaxie/godoc) )，因为他内部就有一个很强大的文档工具 - + 很多人说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中所有项目的相关文档,这对于经常被墙奸的用户来说,是一个不错的选择 -##其他命令 + 通过命令在命令行执行 godoc -http=:端口号 比如`godoc -http=:8080`。然后在浏览器中打开`127.0.0.1:8080`，你将会看到一个golang.org的本地copy版本，通过它你可以查询pkg文档等其它内容。如果你设置了GOPATH，在pkg分类下，不但会列出标准包的文档，还会列出你本地`GOPATH`中所有项目的相关文档，这对于经常被墙的用户来说是一个不错的选择。 - go还提供了其他很多的工具，例如下面的这些工具 +##其它命令 + + go还提供了其它很多的工具，例如下面的这些工具 go fix 用来修复以前老版本的代码到新版本，例如go1之前老版本的代码转化到go1 go version 查看go当前的版本 @@ -104,7 +105,7 @@ go build的时候会选择性的编译系统名结尾的文件(linux、darwin、 ## links * [目录]() * 上一节: [GOPATH与工作空间](<1.2.md>) - * 下一节: [GO开发工具](<1.4.md>) + * 下一节: [Go开发工具](<1.4.md>) -## LastModified +## LastModified * $Id$ diff --git a/1.md b/1.md index f69aa801..d7cfb817 100644 --- a/1.md +++ b/1.md @@ -17,6 +17,7 @@ - 具有垃圾回收机制 - 跨平台，可交叉编译 - 还有更多…… + 总之是一种C+Python动静结合的好语言。 在本章中，我们将讲述Go的安装方法，以及如何配置项目信息。