Skip to content

Commit 2ee6033

Browse files
astaxieastaxie
committed
astaxie#148 感谢polarisreview
1 parent 8ce8607 commit 2ee6033

File tree

9 files changed

+197
-166
lines changed

9 files changed

+197
-166
lines changed

‎01.2.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ GOPATH允许多个目录，当有多个目录时，请注意分隔符，多个
2727
## 应用目录结构
2828
建立包和目录：$GOPATH/src/mymath/sqrt.go（包名："mymath"）
2929

30-
以后自己新建应用或者一个代码包都是在src目录下新建一个文件夹，文件夹名称代码包名称，当然也允许多级目录，例如在src下面新建了目录$GOPATH/src/github.com/astaxie/beedb 那么这个包名称就是“github.com/astaxie/beedb”
30+
以后自己新建应用或者一个代码包都是在src目录下新建一个文件夹，文件夹名称一般是代码包名称，当然也允许多级目录，例如在src下面新建了目录$GOPATH/src/github.com/astaxie/beedb 那么这个包路径就是“github.com/astaxie/beedb”，包名称是最后一个目录beedb
3131

3232
执行如下代码
3333
```sh
@@ -47,7 +47,7 @@ GOPATH允许多个目录，当有多个目录时，请注意分隔符，多个
4747
return z
4848
}
4949
```
50-
这样我的应用包目录和代码已经新建完毕，注意：package的名称必须和目录名保持一致
50+
这样我的应用包目录和代码已经新建完毕，注意：一般建议package的名称和目录名保持一致
5151

5252
## 编译应用
5353
上面我们已经建立了自己的应用包，如何进行编译安装呢？有两种方式可以进行安装
@@ -62,7 +62,7 @@ GOPATH允许多个目录，当有多个目录时，请注意分隔符，多个
6262
//可以看到如下文件
6363
mymath.a
6464
```
65-
这个.a文件是应用包，相当于一个函数库一样，那么我们如何进行调用呢？
65+
这个.a文件是应用包，那么我们如何进行调用呢？
6666

6767
接下来我们新建一个应用程序来调用
6868

@@ -106,6 +106,8 @@ GOPATH允许多个目录，当有多个目录时，请注意分隔符，多个
106106
go语言有一个获取远程包的工具就是`go get`，目前go get支持多数开源社区(例如：github、googlecode、bitbucket、Launchpad)
107107

108108
go get github.com/astaxie/beedb
109+
110+
>go get -u 参数可以自动更新包，而且当go get的时候会自动获取该包依赖的其他第三方包
109111
110112
通过这个命令可以获取相应的源码，对应的开源平台采用不同的源码控制工具，例如github采用git、googlecode采用hg，所以要想获取这些源码，必须先安装相应的源码控制工具
111113

‎01.3.md‎

Lines changed: 115 additions & 110 deletions
Original file line numberDiff line numberDiff line change
@@ -1,110 +1,115 @@
1-
# 1.3 Go 命令
2-
3-
## Go 命令
4-
5-
Go语言自带有一套完整的命令操作工具，你可以通过在命令行中执行`go`来查看它们：
6-
7-
![](images/1.3.go.png?raw=true)
8-
9-
图1.3 Go命令显示详细的信息
10-
11-
这些命令对于我们平时编写的代码非常有用，接下来就让我们了解一些常用的命令。
12-
13-
## go build
14-
15-
这个命令主要用于测试编译。在包的编译过程中，若有必要，会同时编译与之相关联的包。
16-
17-
- 如果是普通包，就像我们在1.2节中编写的`mymath`包那样，当你执行`go build`之后，它不会产生任何文件。如果你需要在`$GOPATH/pkg`下生成相应的文件，那就得执行`go install`了。
18-
19-
- 如果是`main`包，当你执行`go build`之后，它就会在当前目录下生成一个可执行文件。如果你需要在`$GOPATH/bin`下生成相应的文件，同样需要执行`go install`。
20-
21-
- 如果某个项目文件夹下有多个文件，而你只想编译某个文件，就可在`go build`之后加上文件名，例如`go build a.go`；`go build`命令默认会编译当前目录下的所有go文件。
22-
23-
- 你也可以指定编译输出的文件名。例如1.2节中的`mathapp`应用，我们可以指定`go build -o astaxie.exe`，默认情况是你的package名，就是你的文件夹名称。
24-
25-
（注：实际上，package名在[Go语言规范](https://golang.org/ref/spec)中指代码中“package”后使用的名称，此名称可以与文件夹名不同。默认生成的可执行文件名是文件夹名。）
26-
27-
- go build会忽略目录下以“_”或“.”开头的go文件。
28-
29-
- 如果你的源代码针对不同的操作系统需要不同的处理，那么你可以根据不同的操作系统后缀来命名文件。例如有一个读取数组的程序，它对于不同的操作系统可能有如下几个源文件：
30-
31-
array_linux.go
32-
array_darwin.go
33-
array_windows.go
34-
array_freebsd.go
35-
36-
`go build`的时候会选择性地编译以系统名结尾的文件（linux、darwin、windows、freebsd）。例如Linux系统下面编译只会选择array_linux.go文件，其它系统命名后缀文件全部忽略。
37-
38-
## go clean
39-
40-
这个命令是用来移除当前源码包里面编译生成的文件。这些文件包括
41-
42-
_obj/ 旧的object目录，由Makefiles遗留
43-
_test/ 旧的test目录，由Makefiles遗留
44-
_testmain.go 旧的gotest文件，由Makefiles遗留
45-
test.out 旧的test记录，由Makefiles遗留
46-
build.out 旧的test记录，由Makefiles遗留
47-
*.[568ao] object文件，由Makefiles遗留
48-
49-
DIR(.exe) 由go build产生
50-
DIR.test(.exe) 由go test -c产生
51-
MAINFILE(.exe) 由go build MAINFILE.go产生
52-
53-
我一般都是利用这个命令清除编译文件，然后github递交源码，在本机测试的时候这些编译文件都是和系统相关的，但是对于源码管理来说没必要
54-
55-
## go fmt
56-
57-
有过C/C++经验的读者会知道,一些人经常为代码采取K&R风格还是ANSI风格而争论不休。在go中，代码则有标准的风格。由于之前已经有的一些习惯或其它的原因我们常将代码写成ANSI风格或者其它更合适自己的格式，这将为人们在阅读别人的代码时添加不必要的负担，所以go强制了代码格式（比如左大括号必须放在行尾），不按照此格式的代码将不能编译通过，为了减少浪费在排版上的时间，go工具集中提供了一个`go fmt`命令 它可以帮你格式化你写好的代码文件，使你写代码的时候不需要关心格式，你只需要在写完之后执行`go fmt <文件名>.go`，你的代码就被修改成了标准格式，但是我平常很少用到这个命令，因为开发工具里面一般都带了保存时候自动格式化功能，这个功能其实在底层就是调用了`go fmt`。接下来的一节我将讲述两个工具，这两个工具都自带了保存文件时自动化`go fmt`功能。
58-
59-
## go get
60-
61-
这个命令是用来动态获取远程代码包的，目前支持的有BitBucket、GitHub、Google Code和Launchpad。这个命令在内部实际上分成了两步操作：第一步是下载源码包，第二步是执行`go install`。下载源码包的go工具会自动根据不同的域名调用不同的源码工具，对应关系如下：
62-
63-
BitBucket (Mercurial Git)
64-
GitHub (Git)
65-
Google Code Project Hosting (Git, Mercurial, Subversion)
66-
Launchpad (Bazaar)
67-
68-
所以为了`go get` 能正常工作，你必须确保安装了合适的源码管理工具，并同时把这些命令加入你的PATH中。其实`go get`支持自定义域名的功能，具体参见`go help remote`。
69-
70-
## go install
71-
72-
这个命令在内部实际上分成了两步操作：第一步是`go build`，第二步会把编译好的东西move到`$GOPATH/pkg`或者`$GOPATH/bin`。
73-
74-
## go test
75-
76-
执行这个命令，会自动读取源码目录下面名为`*_test.go`的文件，生成并运行测试用的可执行文件。输出的信息类似
77-
78-
ok archive/tar 0.011s
79-
FAIL archive/zip 0.022s
80-
ok compress/gzip 0.033s
81-
...
82-
83-
默认的情况下，不需要任何的参数，它会自动把你源码包下面所有test文件测试完毕，当然你也可以带上参数，详情请参考`go help testflag`
84-
85-
## go doc
86-
87-
很多人说go不需要任何的第三方文档，例如chm手册之类的（其实我已经做了一个了，[chm手册](https://github.com/astaxie/godoc)），因为它内部就有一个很强大的文档工具。
88-
89-
如何查看相应package的文档呢？
90-
例如builtin包，那么执行`go doc builtin`
91-
如果是http包，那么执行`go doc net/http`
92-
查看某一个包里面的函数，那么执行`godoc fmt Printf`
93-
也可以查看相应的代码，执行`godoc -src fmt Printf`
94-
95-
通过命令在命令行执行 godoc -http=:端口号 比如`godoc -http=:8080`。然后在浏览器中打开`127.0.0.1:8080`，你将会看到一个golang.org的本地copy版本，通过它你可以查询pkg文档等其它内容。如果你设置了GOPATH，在pkg分类下，不但会列出标准包的文档，还会列出你本地`GOPATH`中所有项目的相关文档，这对于经常被墙的用户来说是一个不错的选择。
96-
97-
## 其它命令
98-
99-
go还提供了其它很多的工具，例如下面的这些工具
100-
101-
go fix 用来修复以前老版本的代码到新版本，例如go1之前老版本的代码转化到go1
102-
go version 查看go当前的版本
103-
go env 查看当前go的环境变量
104-
go list 列出当前全部安装的package
105-
go run 编译并运行Go程序
106-
107-
## links
108-
* [目录](<preface.md>)
109-
* 上一节: [GOPATH与工作空间](<01.2.md>)
110-
* 下一节: [Go开发工具](<01.4.md>)
1+
# 1.3 Go 命令
2+
3+
## Go 命令
4+
5+
Go语言自带有一套完整的命令操作工具，你可以通过在命令行中执行`go`来查看它们：
6+
7+
![](images/1.3.go.png?raw=true)
8+
9+
图1.3 Go命令显示详细的信息
10+
11+
这些命令对于我们平时编写的代码非常有用，接下来就让我们了解一些常用的命令。
12+
13+
## go build
14+
15+
这个命令主要用于测试编译。在包的编译过程中，若有必要，会同时编译与之相关联的包。
16+
17+
- 如果是普通包，就像我们在1.2节中编写的`mymath`包那样，当你执行`go build`之后，它不会产生任何文件。如果你需要在`$GOPATH/pkg`下生成相应的文件，那就得执行`go install`了。
18+
19+
- 如果是`main`包，当你执行`go build`之后，它就会在当前目录下生成一个可执行文件。如果你需要在`$GOPATH/bin`下生成相应的文件，需要执行`go install`，或者使用`go build -o 路径/a.exe`。
20+
21+
- 如果某个项目文件夹下有多个文件，而你只想编译某个文件，就可在`go build`之后加上文件名，例如`go build a.go`；`go build`命令默认会编译当前目录下的所有go文件。
22+
23+
- 你也可以指定编译输出的文件名。例如1.2节中的`mathapp`应用，我们可以指定`go build -o astaxie.exe`，默认情况是你的package名(非main包)，或者是第一个源文件的文件名(main包)。
24+
25+
（注：实际上，package名在[Go语言规范](https://golang.org/ref/spec)中指代码中“package”后使用的名称，此名称可以与文件夹名不同。默认生成的可执行文件名是文件夹名。）
26+
27+
- go build会忽略目录下以“_”或“.”开头的go文件。
28+
29+
- 如果你的源代码针对不同的操作系统需要不同的处理，那么你可以根据不同的操作系统后缀来命名文件。例如有一个读取数组的程序，它对于不同的操作系统可能有如下几个源文件：
30+
31+
array_linux.go
32+
array_darwin.go
33+
array_windows.go
34+
array_freebsd.go
35+
36+
`go build`的时候会选择性地编译以系统名结尾的文件（linux、darwin、windows、freebsd）。例如Linux系统下面编译只会选择array_linux.go文件，其它系统命名后缀文件全部忽略。
37+
38+
## go clean
39+
40+
这个命令是用来移除当前源码包里面编译生成的文件。这些文件包括
41+
42+
_obj/ 旧的object目录，由Makefiles遗留
43+
_test/ 旧的test目录，由Makefiles遗留
44+
_testmain.go 旧的gotest文件，由Makefiles遗留
45+
test.out 旧的test记录，由Makefiles遗留
46+
build.out 旧的test记录，由Makefiles遗留
47+
*.[568ao] object文件，由Makefiles遗留
48+
49+
DIR(.exe) 由go build产生
50+
DIR.test(.exe) 由go test -c产生
51+
MAINFILE(.exe) 由go build MAINFILE.go产生
52+
53+
我一般都是利用这个命令清除编译文件，然后github递交源码，在本机测试的时候这些编译文件都是和系统相关的，但是对于源码管理来说没必要
54+
55+
## go fmt
56+
57+
有过C/C++经验的读者会知道,一些人经常为代码采取K&R风格还是ANSI风格而争论不休。在go中，代码则有标准的风格。由于之前已经有的一些习惯或其它的原因我们常将代码写成ANSI风格或者其它更合适自己的格式，这将为人们在阅读别人的代码时添加不必要的负担，所以go强制了代码格式（比如左大括号必须放在行尾），不按照此格式的代码将不能编译通过，为了减少浪费在排版上的时间，go工具集中提供了一个`go fmt`命令 它可以帮你格式化你写好的代码文件，使你写代码的时候不需要关心格式，你只需要在写完之后执行`go fmt <文件名>.go`，你的代码就被修改成了标准格式，但是我平常很少用到这个命令，因为开发工具里面一般都带了保存时候自动格式化功能，这个功能其实在底层就是调用了`go fmt`。接下来的一节我将讲述两个工具，这两个工具都自带了保存文件时自动化`go fmt`功能。
58+
59+
>使用go fmt命令，更多时候是用gofmt，而且需要参数-w，否则格式化结果不会写入文件。gofmt -w src，可以格式化整个项目。
60+
61+
## go get
62+
63+
这个命令是用来动态获取远程代码包的，目前支持的有BitBucket、GitHub、Google Code和Launchpad。这个命令在内部实际上分成了两步操作：第一步是下载源码包，第二步是执行`go install`。下载源码包的go工具会自动根据不同的域名调用不同的源码工具，对应关系如下：
64+
65+
BitBucket (Mercurial Git)
66+
GitHub (Git)
67+
Google Code Project Hosting (Git, Mercurial, Subversion)
68+
Launchpad (Bazaar)
69+
70+
所以为了`go get` 能正常工作，你必须确保安装了合适的源码管理工具，并同时把这些命令加入你的PATH中。其实`go get`支持自定义域名的功能，具体参见`go help remote`。
71+
72+
## go install
73+
74+
这个命令在内部实际上分成了两步操作：第一步是生成结果文件(可执行文件或者.a包)，第二步会把编译好的结果移到`$GOPATH/pkg`或者`$GOPATH/bin`。
75+
76+
## go test
77+
78+
执行这个命令，会自动读取源码目录下面名为`*_test.go`的文件，生成并运行测试用的可执行文件。输出的信息类似
79+
80+
ok archive/tar 0.011s
81+
FAIL archive/zip 0.022s
82+
ok compress/gzip 0.033s
83+
...
84+
85+
默认的情况下，不需要任何的参数，它会自动把你源码包下面所有test文件测试完毕，当然你也可以带上参数，详情请参考`go help testflag`
86+
87+
## go doc
88+
89+
很多人说go不需要任何的第三方文档，例如chm手册之类的（其实我已经做了一个了，[chm手册](https://github.com/astaxie/godoc)），因为它内部就有一个很强大的文档工具。
90+
91+
如何查看相应package的文档呢？
92+
例如builtin包，那么执行`go doc builtin`
93+
如果是http包，那么执行`go doc net/http`
94+
查看某一个包里面的函数，那么执行`godoc fmt Printf`
95+
也可以查看相应的代码，执行`godoc -src fmt Printf`
96+
97+
通过命令在命令行执行 godoc -http=:端口号 比如`godoc -http=:8080`。然后在浏览器中打开`127.0.0.1:8080`，你将会看到一个golang.org的本地copy版本，通过它你可以查询pkg文档等其它内容。如果你设置了GOPATH，在pkg分类下，不但会列出标准包的文档，还会列出你本地`GOPATH`中所有项目的相关文档，这对于经常被墙的用户来说是一个不错的选择。
98+
99+
## 其它命令
100+
101+
go还提供了其它很多的工具，例如下面的这些工具
102+
103+
go fix 用来修复以前老版本的代码到新版本，例如go1之前老版本的代码转化到go1
104+
go version 查看go当前的版本
105+
go env 查看当前go的环境变量
106+
go list 列出当前全部安装的package
107+
go run 编译并运行Go程序
108+
109+
以上这些工具还有很多参数没有一一介绍，用户可以使用`go help 命令`获取更详细的帮助信息。
110+
111+
112+
## links
113+
* [目录](<preface.md>)
114+
* 上一节: [GOPATH与工作空间](<01.2.md>)
115+
* 下一节: [Go开发工具](<01.4.md>)

‎01.4.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -404,6 +404,28 @@ Eclipse也是非常常用的开发利器，以下介绍如何使用Eclipse来编
404404
405405
图1.16 调试Go程序
406406

407+
## IntelliJ IDEA
408+
熟悉Java的读者应该对于idea不陌生，idea是通过一个插件来支持go语言的高亮语法,代码提示和重构实现。
409+
410+
1. 先下载idea，idea支持多平台：win,mac,linux，如果有钱就买个正式版，如果不行就使用社区免费版，对于只是开发Go语言来说免费版足够用了
411+
412+
![](images/1.4.idea1.png?raw=true)
413+
414+
2. 安装Go插件，点击菜单File中的Setting，找到Plugins,点击,Broswer repo按钮。国内的用户可能会报错，自己解决哈。
415+
416+
![](images/1.4.idea3.png?raw=true)
417+
418+
3. 这时候会看见很多插件，搜索找到Golang,双击,download and install。等到golang那一行后面出现Downloaded标志后,点OK。
419+
420+
![](images/1.4.idea4.png?raw=true)
421+
422+
然后点 Apply .这时候IDE会要求你重启。
423+
424+
4. 重启完毕后,创建新项目会发现已经可以创建golang项目了：
425+
426+
![](images/1.4.idea5.png?raw=true)
427+
428+
下一步,会要求你输入 go sdk的位置,一般都安装在C:\Go，linux和mac根据自己的安装目录设置，选中目录确定,就可以了。
407429

408430
## links
409431
* [目录](<preface.md>)

0 commit comments

Comments
 (0)