7x31/the-way-to-go_ZH_CN
1
0
Fork 0
mirror of https://github.com/unknwon/the-way-to-go_ZH_CN.git synced 2025-08-11 22:53:43 +08:00
Code Issues Packages Projects Releases Wiki Activity

精校：9.6-9.7

Browse Source
This commit is contained in:
Unknwon
2015-08-08 00:01:26 +08:00
parent a9e5e2aff9
commit ad2719141f
4 changed files with 16 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
README_gc.md
View File

@@ -19,4 +19,4 @@ Golang 编程：245386165
|更新日期 |更新内容 |更新日期 |更新内容
|----------|------------------ |----------|------------------
|2015-08-07|9.5 自定义包和可见性 |2015-08-08|9.7 使用 go install 安装自定义包

4
TOC.md
View File

@@ -72,4 +72,6 @@
- 9.2 [regexp 包](eBook/09.2.md) - 9.2 [regexp 包](eBook/09.2.md)
- 9.3 [锁和 sync 包](eBook/09.3.md) - 9.3 [锁和 sync 包](eBook/09.3.md)
- 9.4 [精密计算和 big 包](eBook/09.4.md) - 9.4 [精密计算和 big 包](eBook/09.4.md)
- 9.5 [自定义包和可见性](eBook/09.5.md) - 9.5 [自定义包和可见性](eBook/09.5.md)
- 9.6 [为自定义包使用 godoc](eBook/09.6.md)
- 9.7 [使用 go install 安装自定义包](eBook/09.7.md)

8
eBook/09.6.md
View File

@@ -1,6 +1,6 @@
# 9.6 为自定义包使用 godoc # 9.6 为自定义包使用 godoc
godoc工具（第 3.6 节）在显示自定义包中的注释也有很好的效果：注释必须以 // 开始并无空行放在声明（包，类型，函数）前。godoc 会为每个文件生成一系列的网页。 godoc工具（第 3.6 节）在显示自定义包中的注释也有很好的效果：注释必须以 `//`` 开始并无空行放在声明（包，类型，函数）前。godoc 会为每个文件生成一系列的网页。
例如： 例如：
@@ -9,7 +9,7 @@ godoc工具（第 3.6 节）在显示自定义包中的注释也有很好的效
godoc -http =:6060 -paht="." godoc -http =:6060 -paht="."
（`.` 是指当前目录，-path 参数可以是 /path/to/my/package1 这样的形式指出 package1 在你源码中的位置或接受用冒号形式分隔的路径，无根目录的路径为相对于当前目录的相对路径） （`.` 是指当前目录，-path 参数可以是 `/path/to/my/package1` 这样的形式指出 package1 在你源码中的位置或接受用冒号形式分隔的路径，无根目录的路径为相对于当前目录的相对路径）
- 在浏览器打开地址：http://localhost:6060 - 在浏览器打开地址：http://localhost:6060
@@ -56,7 +56,7 @@ func (StringArray) Swap
func (Float64Array) Swap func (Float64Array) Swap
Other packages // Other packages
import "doc_example" import "doc_example"
``` ```
@@ -83,7 +83,7 @@ Convenience wrappers for common cases: type IntArray[Top]
Convenience types for common cases: IntArray type IntArray []int Convenience types for common cases: IntArray type IntArray []int
``` ```
如果你在一个团队中工作，并在源代码树被存储在网络硬盘上，就可以使用 godoc 给所有团队成员连续文档的支持。通过设置 sync_minutes=n，你甚至可以让它每 n 分钟自动更新您的文档！ 如果你在一个团队中工作，并在源代码树被存储在网络硬盘上，就可以使用 godoc 给所有团队成员连续文档的支持。通过设置 `sync_minutes=n`，你甚至可以让它每 n 分钟自动更新您的文档！
## 链接 ## 链接

18
eBook/09.7.md
View File

@@ -1,26 +1,24 @@
# 9.7 使用 go install 安装自定义包 # 9.7 使用 go install 安装自定义包
go install 是 Go 中自动包安装工具：如需要将包安装到本地它会从远端仓库下载包：检出，编译，安装一气呵成。 go install 是 Go 中自动包安装工具：如需要将包安装到本地它会从远端仓库下载包：检出、编译和安装一气呵成。
在包安装前的先决条件是要自动处理包自身依赖关系的安装。被依赖的包也会安装到子目录下，但是没有文档和示例：可以到网上浏览。 在包安装前的先决条件是要自动处理包自身依赖关系的安装。被依赖的包也会安装到子目录下，但是没有文档和示例：可以到网上浏览。
被安装包的列表可以在 $GOROOT/goinstall.log 找到。
go install 使用了 GOPATH 变量(详见第 2.2 节)。 go install 使用了 GOPATH 变量(详见第 2.2 节)。
远端包(详见第 9.5 节)： 远端包(详见第 9.5 节)：
假设我们要安装一个有趣的包 tideland（它包含了许多帮助示例，参见：http://code.google.com/p/tideland-cgl）。 假设我们要安装一个有趣的包 tideland（它包含了许多帮助示例，参见 [项目主页](http://code.google.com/p/tideland-cgl)）。
因为我们需要创建目录在 Go 安装目录下，所以我们需要使用 root 或者 su 的身份执行命令。 因为我们需要创建目录在 Go 安装目录下，所以我们需要使用 root 或者 su 的身份执行命令。
确保 Go 环境变量已经设置在 root 用户下的 ./bashrc 文件中。 确保 Go 环境变量已经设置在 root 用户下的 `./bashrc` 文件中。
使用命令安装：`go install tideland-cgl.googlecode.com/hg` 使用命令安装：`go install tideland-cgl.googlecode.com/hg`。
可执行文件 hg.a 将被放到 $GOROOT/pkg/linux_amd64/tideland-cgl.googlecode.com 目录下，源码文件被放置在 $GOROOT/src/tideland-cgl.googlecode.com/hg 目录下，同样有个 hg.a 放置在 _obj 的子目录下。 可执行文件 `hg.a` 将被放到 `$GOROOT/pkg/linux_amd64/tideland-cgl.googlecode.com` 目录下，源码文件被放置在 `$GOROOT/src/tideland-cgl.googlecode.com/hg` 目录下，同样有个 `hg.a` 放置在 `_obj` 的子目录下。
现在就可以在 go 代码中使用这个包中的功能了，例如使用报名 cgl 导入： 现在就可以在 go 代码中使用这个包中的功能了，例如使用包名 cgl 导入：
```go ```go
import cgl "tideland-cgl.googlecode.com/hg" import cgl "tideland-cgl.googlecode.com/hg"
@@ -30,13 +28,13 @@ import cgl "tideland-cgl.googlecode.com/hg"
升级到新的版本： 升级到新的版本：
更新到新版本的 Go 之后本地安装包的二进制文件将全被删除。当调用 install -a 工具将通过读取 $GOROOT/goinstall.log 重新安装以前的安装包。如果你想更新，重编译，重安装所有的go安装包可以使用：`go install -a -u -clean` 或者 `go install -a -u -nuke`。 更新到新版本的 Go 之后本地安装包的二进制文件将全被删除。如果你想更新，重编译、重安装所有的go安装包可以使用：`go install -a`。
go 的版本发布的很频繁，所以需要注意发布版本和包的兼容性。go1 之后都是自己编译自己了。 go 的版本发布的很频繁，所以需要注意发布版本和包的兼容性。go1 之后都是自己编译自己了。
go install 同样可以使用 go install 编译链接并安装本地自己的包（详见第 9.8.2 节）。 go install 同样可以使用 go install 编译链接并安装本地自己的包（详见第 9.8.2 节）。
更多信息可以在 http://golang.org/cmd/go 和 http://golang.org/cmd/goinstall 找到。 更多信息可以在 [官方网站](http://golang.org/cmd/go/) 找到。
## 链接 ## 链接