#148 感谢polarisreview

This commit is contained in:
astaxie
2013-01-21 13:00:49 +08:00
parent 8ce8607f94
commit 2ee60332c0
9 changed files with 197 additions and 166 deletions

View File

@@ -27,7 +27,7 @@ GOPATH允许多个目录当有多个目录时请注意分隔符多个
## 应用目录结构
建立包和目录:$GOPATH/src/mymath/sqrt.go包名"mymath"
以后自己新建应用或者一个代码包都是在src目录下新建一个文件夹文件夹名称代码包名称当然也允许多级目录例如在src下面新建了目录$GOPATH/src/github.com/astaxie/beedb 那么这个包名称就是“github.com/astaxie/beedb”
以后自己新建应用或者一个代码包都是在src目录下新建一个文件夹文件夹名称一般是代码包名称当然也允许多级目录例如在src下面新建了目录$GOPATH/src/github.com/astaxie/beedb 那么这个包路径就是“github.com/astaxie/beedb”包名称是最后一个目录beedb
执行如下代码
```sh
@@ -47,7 +47,7 @@ GOPATH允许多个目录当有多个目录时请注意分隔符多个
return z
}
```
这样我的应用包目录和代码已经新建完毕注意package的名称必须和目录名保持一致
这样我的应用包目录和代码已经新建完毕,注意:一般建议package的名称和目录名保持一致
## 编译应用
上面我们已经建立了自己的应用包,如何进行编译安装呢?有两种方式可以进行安装
@@ -62,7 +62,7 @@ GOPATH允许多个目录当有多个目录时请注意分隔符多个
//可以看到如下文件
mymath.a
```
这个.a文件是应用包相当于一个函数库一样,那么我们如何进行调用呢?
这个.a文件是应用包那么我们如何进行调用呢
接下来我们新建一个应用程序来调用
@@ -106,6 +106,8 @@ GOPATH允许多个目录当有多个目录时请注意分隔符多个
go语言有一个获取远程包的工具就是`go get`目前go get支持多数开源社区(例如github、googlecode、bitbucket、Launchpad)
go get github.com/astaxie/beedb
>go get -u 参数可以自动更新包而且当go get的时候会自动获取该包依赖的其他第三方包
通过这个命令可以获取相应的源码对应的开源平台采用不同的源码控制工具例如github采用git、googlecode采用hg所以要想获取这些源码必须先安装相应的源码控制工具

225
01.3.md
View File

@@ -1,110 +1,115 @@
# 1.3 Go 命令
## Go 命令
Go语言自带有一套完整的命令操作工具你可以通过在命令行中执行`go`来查看它们:
![](images/1.3.go.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`之后加上文件名,例如`go build a.go``go build`命令默认会编译当前目录下的所有go文件。
- 你也可以指定编译输出的文件名。例如1.2节中的`mathapp`应用,我们可以指定`go build -o astaxie.exe`默认情况是你的package名,就是你的文件夹名称
实际上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文件其它系统命名后缀文件全部忽略。
## 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产生
我一般都是利用这个命令清除编译文件然后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 Git)
GitHub (Git)
Google Code Project Hosting (Git, Mercurial, Subversion)
Launchpad (Bazaar)
所以为了`go get` 能正常工作你必须确保安装了合适的源码管理工具并同时把这些命令加入你的PATH中。其实`go get`支持自定义域名的功能,具体参见`go help remote`
## go install
这个命令在内部实际上分成了两步操作:第一步是`go build`第二步会把编译好的东西move到`$GOPATH/pkg`或者`$GOPATH/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 编译并运行Go程序
## links
* [目录](<preface.md>)
* 上一节: [GOPATH与工作空间](<01.2.md>)
* 下一节: [Go开发工具](<01.4.md>)
# 1.3 Go 命令
## Go 命令
Go语言自带有一套完整的命令操作工具你可以通过在命令行中执行`go`来查看它们:
![](images/1.3.go.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文件其它系统命名后缀文件全部忽略。
## 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产生
我一般都是利用这个命令清除编译文件然后github递交源码在本机测试的时候这些编译文件都是和系统相关的但是对于源码管理来说没必要
## 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 src可以格式化整个项目。
## 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`
## go install
这个命令在内部实际上分成了两步操作:第一步是生成结果文件(可执行文件或者.a包),第二步会把编译好的结果移到`$GOPATH/pkg`或者`$GOPATH/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 编译并运行Go程序
以上这些工具还有很多参数没有一一介绍,用户可以使用`go help 命令`获取更详细的帮助信息。
## links
* [目录](<preface.md>)
* 上一节: [GOPATH与工作空间](<01.2.md>)
* 下一节: [Go开发工具](<01.4.md>)

22
01.4.md
View File

@@ -404,6 +404,28 @@ Eclipse也是非常常用的开发利器以下介绍如何使用Eclipse来编
图1.16 调试Go程序
## IntelliJ IDEA
熟悉Java的读者应该对于idea不陌生idea是通过一个插件来支持go语言的高亮语法,代码提示和重构实现。
1. 先下载ideaidea支持多平台win,mac,linux如果有钱就买个正式版如果不行就使用社区免费版对于只是开发Go语言来说免费版足够用了
![](images/1.4.idea1.png?raw=true)
2. 安装Go插件点击菜单File中的Setting找到Plugins,点击,Broswer repo按钮。国内的用户可能会报错自己解决哈。
![](images/1.4.idea3.png?raw=true)
3. 这时候会看见很多插件搜索找到Golang,双击,download and install。等到golang那一行后面出现Downloaded标志后,点OK。
![](images/1.4.idea4.png?raw=true)
然后点 Apply .这时候IDE会要求你重启。
4. 重启完毕后,创建新项目会发现已经可以创建golang项目了
![](images/1.4.idea5.png?raw=true)
下一步,会要求你输入 go sdk的位置,一般都安装在C:\Golinux和mac根据自己的安装目录设置选中目录确定,就可以了。
## links
* [目录](<preface.md>)

108
README.md
View File

@@ -1,53 +1,55 @@
# 《Go Web 编程》
因为自己对Web开发比较感兴趣所以最近抽空在写一本开源的书籍《Go Web编程》《Build Web Application with Golang》。写这本书不表示我能力很强而是我愿意分享和大家一起分享Go写Web应用的一些东西。
- 对于从PHP/Python/Ruby转过来的同学了解Go怎么写Web应用开发的
- 对于从C/C++转过来的同学了解Web到底是怎么运行起来的
我一直认为知识是用来分享的,让更多的人分享自己拥有的一切知识这个才是人生最大的快乐。
这本书目前我放在Github上我现在基本每天晚上抽空会写一些时间有限、能力有限所以希望更多的朋友参与到这个开源项目中来。
## 撰写方法
### 文件命名
每个章节建立一个md文件如第11章的第3节则建立**11.3.md**。
### 代码文件
代码文件置于src目录之下。每小节代码按目录存放。如第11章的第3节的代码保存于**src/11.3/**目录下。在正文中按需要添加代码。
## 格式规范
### 正文
请参看已有章节的规范要注意的是每个章节在底部都需要有一个links节包含“目录”“上一节”和“下一节”的链接。
### 代码
代码要**`go fmt`**后提交。注释文件注明其所属章节。
## 如何编译
`build.go`依赖markdown的一个解析包所以第一步先
go get github.com/russross/blackfriday
这样读者就可以把相应的Markdown文件编译成html文件执行`go build build.go`执行生成的文件就会在底目录下生成相应的html文件
## 交流
欢迎大家加入QQ群259316004 《Go Web编程》专用交流群
大家有问题还可以上德问上一起交流学习http://www.dewen.org/topic/165
## 致谢
首先要感谢Golang-China的QQ群102319854里面的每一个人都很热心同时要特别感谢几个人
- [四月份平民](https://plus.google.com/110445767383269817959) (review代码)
- [Hong Ruiqi](https://github.com/hongruiqi) (review代码)
- [BianJiang](https://github.com/border) (编写go开发工具Vim和Emacs的设置)
- [Oling Cat](https://github.com/OlingCat)(review代码)
- [Wenlei Wu](mailto:spadesacn@gmail.com)(提供一些图片展示)
## 授权许可
除特别声明外,本书中的内容使用[CC BY-SA 3.0 License](http://creativecommons.org/licenses/by-sa/3.0/)(创作共用 署名-相同方式共享3.0许可协议)授权,代码遵循[BSD 3-Clause License](<https://github.com/astaxie/build-web-application-with-golang/blob/master/LICENSE.md>)3项条款的BSD许可协议
## 开始阅读
[开始阅读](<https://github.com/astaxie/build-web-application-with-golang/blob/master/preface.md>)
[![githalytics.com alpha](https://cruel-carlota.pagodabox.com/44c98c9d398b8319b6e87edcd3e34144 "githalytics.com")](http://githalytics.com/astaxie/build-web-application-with-golang)
# 《Go Web 编程》
因为自己对Web开发比较感兴趣所以最近抽空在写一本开源的书籍《Go Web编程》《Build Web Application with Golang》。写这本书不表示我能力很强而是我愿意分享和大家一起分享Go写Web应用的一些东西。
- 对于从PHP/Python/Ruby转过来的同学了解Go怎么写Web应用开发的
- 对于从C/C++转过来的同学了解Web到底是怎么运行起来的
我一直认为知识是用来分享的,让更多的人分享自己拥有的一切知识这个才是人生最大的快乐。
这本书目前我放在Github上我现在基本每天晚上抽空会写一些时间有限、能力有限所以希望更多的朋友参与到这个开源项目中来。
## 撰写方法
### 文件命名
每个章节建立一个md文件如第11章的第3节则建立**11.3.md**。
### 代码文件
代码文件置于src目录之下。每小节代码按目录存放。如第11章的第3节的代码保存于**src/11.3/**目录下。在正文中按需要添加代码。
## 格式规范
### 正文
请参看已有章节的规范要注意的是每个章节在底部都需要有一个links节包含“目录”“上一节”和“下一节”的链接。
### 代码
代码要**`go fmt`**后提交。注释文件注明其所属章节。
## 如何编译
`build.go`依赖markdown的一个解析包所以第一步先
go get github.com/russross/blackfriday
这样读者就可以把相应的Markdown文件编译成html文件执行`go build build.go`执行生成的文件就会在底目录下生成相应的html文件
## 交流
欢迎大家加入QQ群259316004 《Go Web编程》专用交流群
大家有问题还可以上德问上一起交流学习http://www.dewen.org/topic/165
## 致谢
首先要感谢Golang-China的QQ群102319854里面的每一个人都很热心同时要特别感谢几个人
- [四月份平民](https://plus.google.com/110445767383269817959) (review代码)
- [Hong Ruiqi](https://github.com/hongruiqi) (review代码)
- [BianJiang](https://github.com/border) (编写go开发工具Vim和Emacs的设置)
- [Oling Cat](https://github.com/OlingCat)(review代码)
- [Wenlei Wu](mailto:spadesacn@gmail.com)(提供一些图片展示)
- [polaris](https://github.com/polaris1119)(review书)
- [雨痕](https://github.com/qyuhen)(review第二章)
## 授权许可
除特别声明外,本书中的内容使用[CC BY-SA 3.0 License](http://creativecommons.org/licenses/by-sa/3.0/)(创作共用 署名-相同方式共享3.0许可协议)授权,代码遵循[BSD 3-Clause License](<https://github.com/astaxie/build-web-application-with-golang/blob/master/LICENSE.md>)3项条款的BSD许可协议
## 开始阅读
[开始阅读](<https://github.com/astaxie/build-web-application-with-golang/blob/master/preface.md>)
[![githalytics.com alpha](https://cruel-carlota.pagodabox.com/44c98c9d398b8319b6e87edcd3e34144 "githalytics.com")](http://githalytics.com/astaxie/build-web-application-with-golang)

BIN
images/1.4.idea1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

BIN
images/1.4.idea2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 79 KiB

BIN
images/1.4.idea3.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 311 KiB

BIN
images/1.4.idea4.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 532 KiB

BIN
images/1.4.idea5.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 195 KiB