01.3.3 godoc

Go语言自带很多可以使你的程序员生活更加容易的工具。其中一个就是godoc，它可以帮助你在没有网络连接的情况下查看现存包和函数的文档。

godoc工具即可以像一般命令行命令那样直接在终端显示结果，也可以在命令行下启动一个web服务器。启动web服务器的，你需要一个浏览器来查看Go的文档。

第一种方式就像用man命令一样，不过我们查询的是Go的函数和包。因此，为了获取 fmt包中 Printf() 函数的信息，你可以执行下面的命令：



$ go doc fmt.Printf

同样的，你用下面这个命令可以找到fmt包的信息：

$ go doc fmt
`

第二种需要执行godoc命令，并且带有-http参数：

$ godoc -http=:8001

上面命令中的数值，就是那个8001，是HTTP服务器监听的端口号。你可以使用任何你有权限，并且可用的值。然而，注意0到1023是被限制的，只有root用户可用，所以最好是避免使用这之间的一个，选个别的，并且这个端口没有被其他进程占用。

你也可以没有上面程序中那个=，用一个空格代替。下面这个命令和上面的命令是完全一样的：

$ godoc -http :8001

然后，你就可以打开浏览器，访问http://localhost:8001/pkg/,就可以浏览Go的文档了。