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
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
8、进入 C:/Go/bin 目录中查看文件,发现 godoc.exe 仍然不存在。进入 C:/Users/Administrator/go/bin 目录中查看文件,发现 godoc.exe 已经存在,符合预期,如图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
原创文章,作者:carmelaweatherly,如若转载,请注明出处:https://blog.ytso.com/tech/webdev/181490.html