在 Windows 10 中，部署一个 Go 1.13 语言的本地文档浏览 web 服务器的流程(已缺少 godoc.exe)

1、go doc 工具只能获取在 Go 安装目录下 ../go/src 中的注释内容。此外，它还可以作为一个本地文档浏览 web 服务器。在命令行输入 godoc -http=:6060，然后使用浏览器打开 http://localhost:6060 后，你就可以看到本地文档浏览服务器提供的页面。参考网址：https://github.com/unknwon/the-way-to-go_ZH_CN/blob/master/eBook/03.6.md

2、在命令行运行 godoc -http=:6060，报错：无法将“godoc”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。如图1

图1

PS C:\Go> godoc -http=:6060
godoc : 无法将“godoc”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正
确，然后再试一次。
所在位置 行:1 字符: 1
+ godoc -http=:6060
+ ~~~~~
    + CategoryInfo          : ObjectNotFound: (godoc:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

3、进入 C:\Go\bin 目录中查看文件，发现 godoc.exe 不存在

PS C:\Go> cd bin
PS C:\Go\bin> ls


    目录: C:\Go\bin


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       2019/10/31     22:59       14797824 go.exe
-a----       2019/10/31     22:59        3715072 gofmt.exe

4、查看 Go 版本，执行命令：go version，参考网址：https://golang.org/doc/go1.13#godoc ，Godoc Web 服务器不再包含在主要的二进制发行版中。 要在本地运行 godoc 网络服务器，需要先手动安装。

PS C:\Go> go version
go version go1.13.4 windows/amd64

5、go install 编译并安装自身包和依赖包，go install golang.org/x/tools/cmd/godoc，https://github.com/golang/tools/tree/master/godoc 。，参考网址：https://www.shuijingwanwq.com/2019/12/28/3784/ 以解决错误提示。

PS C:\Go> go install golang.org/x/tools/cmd/godoc
C:\Users\Administrator\go\src\golang.org\x\tools\cmd\godoc\main.go:47:2: cannot find package "golang.org/x/xerrors" in a
ny of:
        c:\go\src\golang.org\x\xerrors (from $GOROOT)
        C:\Users\Administrator\go\src\golang.org\x\xerrors (from $GOPATH)
PS C:\Go> set HTTP_PROXY=http://127.0.0.1:50999
PS C:\Go> set HTTPS_PROXY=http://127.0.0.1:50999
PS C:\Go> go install golang.org/x/tools/cmd/godoc
go: downloading golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898
go: extracting golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898

6、在命令行再次运行 godoc -http=:6060，成功

PS C:\Go> godoc -http=:6060
using GOPATH mode

7、使用浏览器打开 http://localhost:6060 ，正常打开，符合预期，如图2

图2

8、进入 C:\Go\bin 目录中查看文件，发现 godoc.exe 仍然不存在。进入 C:\Users\Administrator\go\bin 目录中查看文件，发现 godoc.exe 已经存在，符合预期，如图3

图3

PS C:\Go> cd C:\Go\bin
PS C:\Go\bin> ls


    目录: C:\Go\bin


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       2019/10/31     22:59       14797824 go.exe
-a----       2019/10/31     22:59        3715072 gofmt.exe


PS C:\Go\bin> cd C:\Users\Administrator\go\bin
PS C:\Users\Administrator\go\bin> ls


    目录: C:\Users\Administrator\go\bin


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       2020/02/20     18:17       16660480 godoc.exe
-a----       2020/02/20     18:34       14633984 tour.exe