Skip to content

Commit 153ba61

Browse files
astaxieastaxie
authored
Merge pull request astaxie#1149 from vcaesar/u1-pr
Update incorrect and outdated content
2 parents 97f42ba + 70469f5 commit 153ba61

File tree

5 files changed

+342
-250
lines changed

5 files changed

+342
-250
lines changed

‎zh/01.1.md

+65-58
Original file line numberDiff line numberDiff line change
@@ -3,63 +3,24 @@
33
## Go的三种安装方式
44
Go有多种安装方式，你可以选择自己喜欢的。这里我们介绍三种最常见的安装方式：
55

6+
- Go标准包安装：Go提供了方便的安装包，支持Windows、Linux、Mac等系统。这种方式适合快速安装，可根据自己的系统位数下载好相应的安装包，一路 next 就可以轻松安装了。**推荐这种方式**
7+
- 第三方工具安装：目前有很多方便的第三方软件包工具，例如 Ubuntu 的 apt-ge t和 wget、Mac 的 homebrew 等。这种安装方式适合那些熟悉相应系统的用户。
68
- Go源码安装：这是一种标准的软件安装方式。对于经常使用Unix类系统的用户，尤其对于开发者来说，从源码安装可以自己定制。
7-
- Go标准包安装：Go提供了方便的安装包，支持Windows、Linux、Mac等系统。这种方式适合快速安装，可根据自己的系统位数下载好相应的安装包，一路next就可以轻松安装了。**推荐这种方式**
8-
- 第三方工具安装：目前有很多方便的第三方软件包工具，例如Ubuntu的apt-get和wget、Mac的homebrew等。这种安装方式适合那些熟悉相应系统的用户。
99

1010
最后，如果你想在同一个系统中安装多个版本的Go，你可以参考第三方工具[GVM](https://github.com/moovweb/gvm)，这是目前在这方面做得最好的工具，除非你知道怎么处理。
1111

12-
## Go源码安装
13-
Go 1.5彻底移除C代码，Runtime、Compiler、Linker均由Go编写,实现自举。只需要安装了上一个版本,即可从源码安装。
14-
15-
在Go 1.5前,Go的源代码中，有些部分是用Plan 9 C和AT&T汇编写的，因此假如你要想从源码安装，就必须安装C的编译工具。
16-
17-
在Mac系统中，只要你安装了Xcode，就已经包含了相应的编译工具。
18-
19-
在类Unix系统中，需要安装gcc等工具。例如Ubuntu系统可通过在终端中执行`sudo apt-get install gcc libc6-dev`来安装编译工具。
20-
21-
在Windows系统中，你需要安装MinGW，然后通过MinGW安装gcc，并设置相应的环境变量。
22-
23-
你可以直接去官网[下载源码](http://golang.org/dl/)，找相应的`goVERSION.src.tar.gz`的文件下载，下载之后解压缩到`$HOME`目录，执行如下代码：
24-
25-
cd go/src
26-
./all.bash
27-
28-
运行all.bash后出现"ALL TESTS PASSED"字样时才算安装成功。
29-
30-
上面是Unix风格的命令，Windows下的安装方式类似，只不过是运行`all.bat`，调用的编译器是MinGW的gcc。
31-
32-
如果是Mac或者Unix用户需要设置几个环境变量，如果想重启之后也能生效的话把下面的命令写到`.bashrc`或者`.zshrc`里面，
33-
34-
export GOPATH=$HOME/gopath
35-
export PATH=$PATH:$HOME/go/bin:$GOPATH/bin
36-
37-
如果你是写入文件的，记得执行`bash .bashrc`或者`bash .zshrc`使得设置立马生效。
38-
39-
如果是window系统，就需要设置环境变量，在path里面增加相应的go所在的目录，设置gopath变量。
40-
41-
当你设置完毕之后在命令行里面输入`go`，看到如下图片即说明你已经安装成功
42-
43-
![](images/1.1.mac.png?raw=true)
44-
45-
图1.1 源码安装之后执行Go命令的图
46-
47-
如果出现Go的Usage信息，那么说明Go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了Go的安装目录。
48-
49-
从go 1.8开始，GOPATH环境变量现在有一个默认值，如果它没有被设置。 它在Unix上默认为$HOME/go,在Windows上默认为%USERPROFILE%/go。
50-
> 关于上面的GOPATH将在下面小节详细讲解
5112

5213
## Go标准包安装
5314

54-
Go提供了每个平台打好包的一键安装，这些包默认会安装到如下目录：/usr/local/go (Windows系统：c:\Go)，当然你可以改变他们的安装位置，但是改变之后你必须在你的环境变量中设置如下信息：
15+
Go 提供了每个平台打好包的一键安装，这些包默认会安装到如下目录：/usr/local/go (Windows系统：c:\Go)，当然你可以改变他们的安装位置，但是改变之后你必须在你的环境变量中设置如下信息：
5516

5617
export GOROOT=$HOME/go
57-
export GOPATH=$HOME/gopath
18+
export GOPATH=$HOME/gopath (可选配置)
5819
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
5920

6021
上面这些命令对于Mac和Unix用户来说最好是写入`.bashrc`或者`.zshrc`文件，对于windows用户来说当然是写入环境变量。
6122

62-
### 如何判断自己的操作系统是32位还是64位？
23+
### 如何判断自己的操作系统是32位还是64位？(建议直接跳过, 现在操作系统一般都是 64位)
6324

6425
我们接下来的Go安装需要判断操作系统的位数，所以这小节我们先确定自己的系统类型。
6526

@@ -70,28 +31,29 @@ Mac系统用户建议直接使用64位的，因为Go所支持的Mac OS X版本
7031
Linux系统用户可通过在Terminal中执行命令`arch`(即`uname -m`)来查看系统信息：
7132

7233
64位系统显示
73-
7434
x86_64
7535

7636
32位系统显示
77-
7837
i386
7938

8039
### Mac 安装
8140

82-
访问[下载地址][downlink]，32位系统下载go1.4.2.darwin-386-osx10.8.pkg(更新的版本已无32位下载)，64位系统下载go1.8.3.darwin-amd64.pkg，双击下载文件，一路默认安装点击下一步，这个时候go已经安装到你的系统中，默认已经在PATH中增加了相应的`~/go/bin`,这个时候打开终端，输入`go`
41+
访问[下载地址][downlink]，64位系统下载 go1.14.7.darwin-amd64.pkg，双击下载文件，一路默认安装点击下一步，这个时候go已经安装到你的系统中，默认已经在PATH中增加了相应的`~/go/bin`, 这个时候打开终端，输入`go`
42+
32位系统下载go1.4.2.darwin-386-osx10.8.pkg( 新的版本已无32位下载 )
8343

8444
看到类似上面源码安装成功的图片说明已经安装成功
8545

8646
如果出现go的Usage信息，那么说明go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了go的安装目录。
8747

8848
### Linux 安装
8949

90-
访问[下载地址][downlink]，32位系统下载go1.8.3.linux-386.tar.gz，64位系统下载go1.8.3.linux-amd64.tar.gz，
50+
访问[下载地址][downlink]，64位系统下载go1.14.7.linux-amd64.tar.gz，32位系统下载go1.14.7.linux-386.tar.gz，
9151

92-
假定你想要安装Go的目录为 `$GO_INSTALL_DIR`，后面替换为相应的目录路径。
52+
直接使用 `tar -C /usr/local -xzf go1.4.7.linux-amd64.tar.gz` 解压到 local 目录
53+
设置PATH，`export PATH=$PATH:/usr/local/go/bin`
9354

94-
解压缩`tar.gz`包到安装目录下：`tar zxvf go1.8.3.linux-amd64.tar.gz -C $GO_INSTALL_DIR`。
55+
假定你想要安装Go的目录为 `$GO_INSTALL_DIR`，后面替换为相应的目录路径。
56+
解压缩`tar.gz`包到安装目录下：`tar zxvf go1.14.7.linux-amd64.tar.gz -C $GO_INSTALL_DIR`。
9557

9658
设置PATH，`export PATH=$PATH:$GO_INSTALL_DIR/go/bin`
9759

@@ -105,14 +67,15 @@ Linux系统用户可通过在Terminal中执行命令`arch`(即`uname -m`)来查
10567

10668
### Windows 安装 ###
10769

108-
访问[Golang 下载页][downlink]，32 位请选择名称中包含 windows-386 的 msi 安装包，64 位请选择名称中包含 windows-amd64 的。下载好后运行，不要修改默认安装目录 C:\Go\，若安装到其他位置会导致不能执行自己所编写的 Go 代码。安装完成后默认会在环境变量 Path 后添加 Go 安装目录下的 bin 目录 `C:\Go\bin\`，并添加环境变量 GOROOT，值为 Go 安装根目录 `C:\Go\` 。
70+
访问[Golang 下载页][downlink]，64 位请选择名称中包含 windows-amd64 的, 32 位请选择名称中包含 windows-386 的 msi 安装包。下载好后运行，不要修改默认安装目录 C:\Go\，若安装到其他位置会导致不能执行自己所编写的 Go 代码。安装完成后默认会在环境变量 Path 后添加 Go 安装目录下的 bin 目录 `C:\Go\bin\`，并添加环境变量 GOROOT，值为 Go 安装根目录 `C:\Go\` 。
10971

11072
**验证是否安装成功**
11173

11274
在运行中输入 `cmd` 打开命令行工具，在提示符下输入 `go`，检查是否能看到 Usage 信息。输入 `cd %GOROOT%`，看是否能进入 Go 安装目录。若都成功，说明安装成功。
11375

11476
不能的话请检查上述环境变量 Path 和 GOROOT 的值。若不存在请卸载后重新安装，存在请重启计算机后重试以上步骤。
11577

78+
11679
## 第三方工具安装
11780

11881
### GVM
@@ -125,11 +88,11 @@ bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/bins
12588
安装完成后我们就可以安装go了：
12689
```sh
12790

128-
gvm install go1.8.3
129-
gvm use go1.8.3
91+
gvm install go1.14.7
92+
gvm use go1.14.7
13093
```
13194
也可以使用下面的命令，省去每次调用gvm use的麻烦：
132-
gvm use go1.8.3 --default
95+
gvm use go1.14.7 --default
13396

13497
执行完上面的命令之后GOPATH、GOROOT等环境变量会自动设置好，这样就可以直接使用了。
13598

@@ -145,8 +108,10 @@ sudo apt-get install golang-stable git-core mercurial
145108
### wget
146109
```sh
147110

148-
wget https://storage.googleapis.com/golang/go1.8.3.linux-amd64.tar.gz
149-
sudo tar -xzf go1.8.3.linux-amd64.tar.gz -C /usr/local
111+
wget https://storage.googleapis.com/golang/go1.14.7.linux-amd64.tar.gz
112+
或 wget https://dl.google.com/go/go1.14.7.linux-amd64.tar.gz
113+
114+
sudo tar -xzf go1.14.7.linux-amd64.tar.gz -C /usr/local
150115
```
151116

152117
配置环境变量:
@@ -189,12 +154,54 @@ homebrew是Mac系统下面目前使用最多的管理软件的工具，目前已
189154
brew update && brew upgrade
190155
brew install go
191156
brew install git
192-
brew install mercurial //可选安装
157+
brew install mercurial // 可选安装
193158
```
194159

160+
## Go源码安装
161+
Go 1.5彻底移除 C 代码，Runtime、Compiler、Linker均由Go编写,实现自举。只需要安装了上一个版本,即可从源码安装。
162+
163+
在Go 1.5前,Go的源代码中，有些部分是用Plan 9 C和AT&T汇编写的，因此假如你要想从源码安装，就必须安装C的编译工具。
164+
165+
在Mac系统中，只要你安装了Xcode，就已经包含了相应的编译工具。
166+
167+
在类Unix系统中，需要安装gcc等工具。例如Ubuntu系统可通过在终端中执行`sudo apt-get install gcc libc6-dev`来安装编译工具。
168+
169+
在 Windows 系统中，你需要安装 MinGW，然后通过 MinGW 安装 gcc，并设置相应的环境变量。
170+
171+
你可以直接去官网[下载源码](http://golang.org/dl/)，找相应的`goVERSION.src.tar.gz`的文件下载，下载之后解压缩到`$HOME`目录，执行如下代码：
172+
173+
cd go/src
174+
./all.bash
175+
176+
运行all.bash后出现"ALL TESTS PASSED"字样时才算安装成功。
177+
178+
上面是Unix风格的命令，Windows下的安装方式类似，只不过是运行`all.bat`，调用的编译器是MinGW的gcc。
179+
180+
如果是Mac或者Unix用户需要设置几个环境变量，如果想重启之后也能生效的话把下面的命令写到`.bashrc`或者`.zshrc`里面，
181+
182+
export GOPATH=$HOME/gopath
183+
export PATH=$PATH:$HOME/go/bin:$GOPATH/bin
184+
185+
如果你是写入文件的，记得执行`bash .bashrc`或者`bash .zshrc`使得设置立马生效。
186+
187+
如果是window系统，就需要设置环境变量，在path里面增加相应的go所在的目录，设置gopath变量。
188+
189+
当你设置完毕之后在命令行里面输入`go`，看到如下图片即说明你已经安装成功
190+
191+
![](images/1.1.mac.png?raw=true)
192+
193+
图1.1 源码安装之后执行Go命令的图
194+
195+
如果出现Go的Usage信息，那么说明Go已经安装成功了；如果出现该命令不存在，那么可以检查一下自己的PATH环境变中是否包含了Go的安装目录。
196+
197+
从go 1.8开始，GOPATH 环境变量现在有一个默认值，如果它没有被设置。 它在Unix上默认为$HOME/go,在Windows上默认为%USERPROFILE%/go。
198+
从 Go1.11 开始, Go 官方加入了 Go Module 支持.
199+
> 关于上面的 GO Module 和 GOPATH 将在下面小节详细讲解
200+
201+
195202
## links
196203
* [目录](<preface.md>)
197204
* 上一节: [Go环境配置](<01.0.md>)
198-
* 下一节: [GOPATH 与工作空间](<01.2.md>)
205+
* 下一节: [Go Module, GOPATH 与工作空间](<01.2.md>)
199206

200207
[downlink]:http://golang.org/dl/ "Go安装包下载"

‎zh/01.2.md

+76-3
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,80 @@
1-
# 1.2 GOPATH与工作空间
1+
# 1.2 Go Module, GOPATH 与工作空间
22

3-
前面我们在安装Go的时候看到需要设置GOPATH变量，Go从1.1版本到1.7必须设置这个变量，而且不能和Go的安装目录一样，这个目录用来存放Go源码，Go的可运行文件，以及相应的编译之后的包文件。所以这个目录下面有三个子目录：src、bin、pkg
3+
从 Go1.11 开始, Go 官方加入 Go Module 支持, Go1.12 成为默认支持; 从此告别源码必须放在 Gopath 中
4+
以及 Gopath 对初学者造成的困扰.
45

5-
从go 1.8开始，GOPATH环境变量现在有一个默认值，如果它没有被设置。 它在Unix上默认为$HOME/go,在Windows上默认为%USERPROFILE%/go。
6+
## 使用 Go Module
7+
8+
由于众所周知的原因, 要顺利安装 Go Module 的包, 需要先设置代理:
9+
10+
公共模块代理:
11+
```sh
12+
export GOPROXY=https://goproxy.io // 也可以设置为 https://goproxy.cn 或者其他
13+
```
14+
15+
私有模块代理:
16+
```sh
17+
export GOPRIVATE=git.xxx.com
18+
```
19+
20+
初始化:
21+
```
22+
go mod init [module 名称]
23+
```
24+
25+
检测和清理依赖:
26+
```
27+
go mod tidy
28+
```
29+
30+
安装指定包:
31+
```
32+
go get -v github/com/go-ego/gse@v0.60.0-rc4.2
33+
```
34+
35+
### 更新依赖
36+
```
37+
go get -u
38+
```
39+
更新指定包依赖:
40+
```
41+
go get -u github.com/go-ego/gse
42+
```
43+
指定版本:
44+
```
45+
go get -u github/com/go-ego/gse@v0.60.0-rc4.2
46+
```
47+
48+
### Replace:
49+
50+
使用命令行:
51+
```
52+
go mod edit -replace github.com/go-ego/gse=/path/to/local/gse
53+
go mod edit -replace github.com/go-ego/gse=github.com/vcaesar/gse
54+
```
55+
也可以直接修改模块文件:
56+
57+
```
58+
replace github.com/go-ego/gse => github.com/vcaesar/gse
59+
```
60+
61+
## GOMODULE 常用命令:
62+
63+
```
64+
go mod init # 初始化 go.mod
65+
go mod tidy # 更新依赖文件
66+
go mod download # 下载依赖文件
67+
68+
go mod vendor # 将依赖转移至本地的 vendor 文件
69+
go mod edit # 手动修改依赖文件
70+
go mod graph # 打印依赖图
71+
go mod verify # 校验依赖
72+
```
73+
74+
75+
前面我们在安装 Go 的时候看到需要设置 GOPATH 变量，Go 从1.1版本到1.7必须设置这个变量，而且不能和Go的安装目录一样，这个目录用来存放Go源码，Go的可运行文件，以及相应的编译之后的包文件。所以这个目录下面有三个子目录：src、bin、pkg
76+
77+
从go 1.8开始，GOPATH 环境变量现在有一个默认值，如果它没有被设置。 它在Unix上默认为$HOME/go,在Windows上默认为%USERPROFILE%/go。
678
## GOPATH设置
779
go 命令依赖一个重要的环境变量：$GOPATH
880

@@ -14,6 +86,7 @@
1486
```sh
1587
export GOPATH=/home/apple/mygo
1688
```
89+
1790
为了方便，应该新建以上文件夹，并且上一行加入到 `.bashrc` 或者 `.zshrc` 或者自己的 `sh` 的配置文件中。
1891

1992
Windows 设置如下，新建一个环境变量名称叫做GOPATH：

‎zh/01.3.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -200,5 +200,5 @@ gofmt的参数介绍
200200

201201
## links
202202
* [目录](<preface.md>)
203-
* 上一节: [GOPATH与工作空间](<01.2.md>)
203+
* 上一节: [Go Module, GOPATH与工作空间](<01.2.md>)
204204
* 下一节: [Go开发工具](<01.4.md>)

0 commit comments

Comments
 (0)