在 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


 

永夜