help doc`查看`go doc`命令的[详细使用方式](https://juejin.cn/post/7100017311637045256): go help doc usage: go doc...复制代码 而godoc 是一个文档生成工具,通过解析项目.go文件中包含注释的,来生成HTML或文本类型的文档 。通过在本地启动一个web程序,可以在浏览器来展示项目的文档。...Godoc将使用注释的文本来形成包的文档(粒度是某个package,而不是具体到某个.go文件) 官方介绍 Godoc: documenting Go code Go 1.5之前godoc也是一个内置的命令...这个索引会在服务器启动时创建并维护。...---- godoc个人项目 godoc默认展示的是官方标准库的内容,个人项目如何使用godoc生成文档?
平时我们看 golang 文档的方式通常有: go doc golang.org/pkg 或者国内的 godoc.golangtc.com/pkg/ 看源码,当然这是最好的方式,只是需要更多的时间和耐心...后来了解到,godoc -html 可以生成 HTML 文档,所以就思考如何搭建本地的 localhost:3000/pkg 先取个名字,godocserver 步骤如下: 获取所有...golang built-in packages 名称 遍历所有 packages 运行 godoc -html 保存所有文件,启动一个静态文件服务器 利用 Ruby 实现 步骤1...、2,要注意遍历 $GOPATH/src/ 时要过滤一些不需要的目录,创建文件时,要先创建对应的目录。...启动静态服务器用 golang 和 ruby 都可以,我用的是 negroni,就三行代码。
---- 做 Go 开发时,我们在开源项目的主页上我们经常可以看到这样的一个徽章: [5uh2vuyc8.svg] 点击徽章,就可以打开 godoc.org 的网页,网页中给出了这个开源项目所对应的...而 godoc 命令的作用,则是可以让我们在本地建立一个属于自己的 godoc 网站服务(官方的 godoc 其实也基本上是用同一个工具建立起来的)。...自建的 godoc 有两个作用,一是解决某局域网内无法访问 godoc.org 的尴尬,另一个则是可以本地调试自己的文档。...我们可以用下面的命令在本地启动自己的 godoc 服务: godoc -http=127.0.0.1:6060 -play 或者简写为: godoc -http=:6060 -play 在浏览器输入 http...Overview 的文字部分 请读者打开 doc.go,然后对比 godoc,就可以对照着看到文字部分是怎么被 godoc 呈现出来的。
可以直接在本地浏览器访问8888端口, 查看这个运行在本地的文档服务: localhost:8888. 能够看到所有官方包的文档. 而这些文档内容都是从官方代码包中读取的....开头空格标识缩进 */ // 同时, 也可以写成多个单行注释的形式 package doc 展示形式: ?...对于包的说明文档, 因为包下每个文件都有package doc 这段代码, 如果包下有多个文件都对此包进行了说明, 文档会将所有说明拼接到一起....可以单独建一个doc.go的空文件, 专门用来写包文档....image-20200719161655341 Deprecated 已弃用的标识, 这个关键字看的太多了, 不过godoc并不会识别这个关键字, 主要是编译器识别. // Deprecated: 请使用
目前的godoc和pkgsite有两个作用,一个是用来本地调试自己的GoDoc显示效果;另一个是在无法科学上网的时候,用来本地搭建GoDoc服务器之用。 二、godoc命令 我们从工具命令开始讲起吧。...在2019年之前,Go使用的是godoc这个工具来格式化和展示Go代码中自带的文档。...Go秉承“注释即文档”的理念,其中pkg.go.dev、godoc和pkgsite都使用同一套GoDoc格式,三者都按照该格式从文档的注释中提取,并生成文档。...文件,用来写包注释,比如这样:(https://github.com/Andrew-M-C/go.jsonvalue/blob/v1.0.0/doc.go#L1) 七、弃用代码声明 Go所使用的版本号是...但是实际上,我们在做一些小版本或中版本升级时,有些函数/类型可能不再推荐使用。
《Go语言实战》读书笔记,未完待续,欢迎关注公众号flysnow_org,第一时间看后续笔记。...Go提供了两种查看文档的方式,一种是使用go doc命令在终端查看,这种适用于使用VIM等工具在终端开发的人员,它们不用离开终端,既可以查看想查看的文档,又可以编码。...第二种方式,是使用浏览器查看的方式,通过godoc命令可以在本机启动一个web服务,我们可以通过打开浏览器,访问这个服务来查看我们的Go文档。...要想启动一个Web在线API文档服务很简单,使用godoc就可以了。...想要为哪些标识符生车文档,就在哪些标识符之前,使用注释的方式,加入到代码中即可。 现在我们不管是用go doc,还是godoc都可以看到我们刚刚注释的文档了。
,一个是用来本地调试自己的 GoDoc 显示效果;另一个是在无法科学上网的时候,用来本地搭建 GoDoc 服务器之用。...---- godoc 命令 我们从工具命令开始讲起吧。在 2019 年之前,Go 使用的是 godoc 这个工具来格式化和展示 Go 代码中自带的文档。...下面会有一个与 package 名称同名的 xxx.go 文件,那我们可以统一就在这个文件里写包注释,比如这样; 如果 xxx.go 文件本身承载了较多代码,或者是包注释比较长,那么我们可以专门开一个 doc.go...弃用代码声明 Go 所使用的版本号是 vX.Y.Z 的模式,按照官方的思想,每当 package 升级时,尽量不要升级大版本X值,这也同时代表着,本次升级是完全向前兼容的。...但是实际上,我们在做一些小版本或中版本升级时,有些函数/类型可能不再推荐使用。
运行测试 使用ide查看代码覆盖 使用go test获取代码覆盖报告 使用go tool cover查看代码覆盖报告 使用test.B的使用 使用pprof优化性能 三.测试HTTP服务器 go test...request/response(在httptest库中,速度快,密度细,像单元测试) 通过起服务器(集成度高,代码覆盖量大) 四.查看文档 go doc go help doc //帮助文档 连起来的...go 1.13 版本后 移除了godoc相关的一些命令,因此需手动安装 下面是安装使用该命令的方法: 第一步 进入命令行 输入下面两行代码 go env -w GO111MODULE=on go env...第二步 命令行输入,安装godoc go get golang.org/x/tools/cmd/godoc 安装完成后即可使用godoc命令,生成文档 sudo apt-get install golang-doc...-http=localhost:6060后, 直接在浏览器,访问 http://localhost:6060/pkg/ 用注释写文档 在测试中加入example 使用go doc/godoc 来查看
可以直接在命令行执行 go doc strings.Fields 获取库函数的解释;执行 go get golang.org/x/tools/cmd/godoc 会安装 godoc 工具,注意这两者是不同的...前者是 go 命令,后者则是 godoc 命令。...执行 godoc -http :8080 可以启动一个 server,访问 http://localhost:8080/pkg/ 即可看到 Go 的文档。...使用 go 关键字启动子协程工作,使用 sync.Wait 和 channel 来收集结果。...告诉我们不要老想着性能优化,在真的出现问题、出现瓶颈的时候再来考虑。
命令 描述 go bug 启动一个用于报告bug的工具。 go build 编译Go程序包及其依赖项。 go clean 删除编译生成的对象文件和缓存文件。 go doc 显示有关包或符号的文档。...您可以指定一个逗号分隔的函数列表,go vet 将检查是否正确使用了这些函数来格式化字符串。 -composites: 检查使用复合文字(composite literals)时的问题。...-t 同时也下载需要为运行测试所需要的包 -u 强制使用网络去更新包和它的依赖包 -v 显示执行的命令 看一个实际的例子: 在本地通过源码安装 Go 的调试器 Delve,可以这么做: go get...doc:显示包的文档。 pprof:分析和查看分析数据。 trace:编译时跟踪工具。 link:链接器工具,查看二进制文件依赖。 addr2line:转换地址为文件/行号。...$ go generate $ go build $ go test 1.10 godoc 在Go1.2版本之前还支持go doc命令,但是之后全部移到了godoc这个命令下,需要这样安装go get
如果不使用子命令 -u,直接使用 go get 下载包时,如果本地已存在要下载的包,将会直接使用本地已存在的包。...交叉编译: 通常我们在 Windows 或 Mac OS 操作系统平台下开发,但是服务器一般是 Linux 系统,在一个平台下编译出其它平台可以运行的可执行文件,就需要使用交叉编译。...vet 可以检测的错误分别是,Printf 类函数调用时,类型匹配错误的参数;定义常用的方法时,方法签名的错误;错误的结构标签;没有指定字段名的结构字面量。...通常用于将源码发布到代码库时,防止可执行文件也发布到代码库。...08 包的文档化 doc go doc 命令行工具可以输出文档注释,参数可以是包名,包成员,方法名。 godoc godoc 命令行工具可以提供一个 HTML 页面来浏览文档注释。
下载包 使用Go语言工具箱的go命令,不仅可以根据包导入路径找到本地工作区的包,甚至可以从互联网上找到和更新包。 使用命令 goget可以下载一个单一的包或者用 ...下载整个子目录里面的每个包。...goget命令获取的代码是真实的代码仓库,而不仅仅只是复制源文件,因此你依然可以使用版本管理工具比较本地代码的变更或者切换到其它的版本。...如果不包含该标志参数的话,而且如果包已经在本地存在,那么将不会被自动更新。...第二个工具,名字也叫 godoc,它提供可以相互交叉引用的HTML页面,但是包含和 go doc命令相同以及更多的信息。...godoc的在线服务 https://godoc.org ,包含了成千上万的开源包的检索工具。 你也可以在自己的工作区目录运行godoc服务。
go build -gcflags "-N -l" -o test test.go go clean执行go clean 命令会删除掉执行其它命令时产生的一些文件和目录,包括: 使用go build 命令时在当前代码包下生成的与包名同名或者与...go doc [-u] [-c] [package|[package.]symbol[.method]] -c 加入此标记后会使go doc命令区分参数中字母的大小写。...godoc fmt godoc -http=:6060 标记-http的值:6060表示启动的Web服务器使用本机的6060端口。...默认情况下,该命令只会从网络上下载本地不存在的代码包,而不会更新已有的代码包。 -x 可以看到go get命令执行过程中所使用的所有命令 智能下载命令go get还有一个很值得称道的功能。...在使用它检出或更新代码包之后,它会寻找与本地已安装Go语言的版本号相对应的标签(tag)或分支(branch)。
,否则编译报错 // 可以使用()将包的名字保卫起来,并且每个包名占用一行 func main() { // 程序入口,声明main函数,即程序启动运行第一个函数,main函数只能声明在main...为了区分本地机器和目标机器,你可以使用 GOHOSTOS 和 GOHOSTARCH 设置本地机器的操作系统名称和编译体系结构,这两个变量只有在进行交叉编译的时候才会用到,如果你不进行显示设置,他们的值会和本地机器...一般用法 # go doc package 获取包的文档注释,例如:go doc fmt 会显示使用 godoc 生成的 fmt 包的文档注释。...此外,它还可以作为一个本地文档浏览 web 服务器。...# 在命令行输入 godoc -http=:6060,然后使用浏览器打开 http://localhost:6060 后, # 你就可以看到本地文档浏览服务器提供的页面。
main包: 它就会在当前目录下生成一个可执行文件,如果你需要在$GOPATH/bin 下生成相应的文件,需要执行 go install,或者使用 go build -o 路径/a.exe 建议使用 -...go build -gcflags "-N -l" -o test test.go 只编译一个文件, go build 后加上文件名,如go build a.go 默认使用package名,指定名用-o...go doc 查看对应包的文档,如 执行 go doc net/http 查看http包里面的函数. 一般使用ide 直接进去看,一般不这么用。 godoc -http=:端口号,配置GOPATH....如 godoc -http=:8080, 浏览器中访问 http://localhost:8080,查看本地和自己写的文档 go doc fmt Printf go fix 用来修复以前老版本的代码到新版本
概述 除了gofmt与godoc外,GO中的命令一般都可通过go命令调用,这些命令可理解为go的子命令,查看下命令列表,如下: $ go Go is a tool for managing Go source...objdump 反汇编命令 pack 似乎是个打包压缩命令 pprof 自带的性能分析工具 test2json 用于把测试文件转化可读的json格式 tour 启动本地的...这些命令有go bug、go doc、go tool tourl等。 go bug会直接启动浏览器并进入github的go项目的issue之下,还会把用户当前环境信息自动添加到issue中。...我们也可以像官网文档那样用浏览器查看文档,只需执行godoc -http=:6060,便会启动一个本地的web服务。...在对它们有了基本认识后,在以后遇到问题时,我们才能想到它们,以及更快地掌握和使用它们。
今天,作为猫头虎博主,我要引领大家探索Go语言的神器——Godoc。 深入这篇文章,你将发现如何使用Godoc来维护和美化你的Go代码,使其通俗易懂,维护性更佳。...遗留代码与弃用警告 当一个结构体字段、函数、类型或整个包变得多余或不必要时,为了保持向后兼容性,需要保留它们。在文档注释中添加“Deprecated:”段落,以指示不应再使用该标识符。...// 当操作数均非字符串时,会在它们之间添加空格。 // 它返回写入的字节数以及遇到的任何写入错误。...package sort 使用Godoc的优势 Godoc的最大优势在于它的简约。遵循上述的注释约定,你的Go代码就可以呈现出良好的文档。...Godoc: documenting Go code. Retrieved from Go Blog Go官方文档: Go Doc Comments
go技巧分享(一) 这是一个系列文章,主要分享go的使用建议和技巧,每次分享3点,希望你能有所收获。...使用示例如下: go doc package:获取包的文档信息 go doc package/subpackage:获取子包的文档信息 go doc package.function:获取包中函数的文档信息...或者通过godoc,可以生成web版的文档信息,在命令行输入godoc -http=:6060,然后使用浏览器打开http://localhost:6060,就可以看到web版的文档信息。...fmt.Printf("num = %s\n", num) fmt.Printf("num = %d\n", 1, 2, 3) } func main() { Func(1) } 使用...3 编译时传递参数 示例代码demo.go如下: package main import "fmt" var BuildDate = "no build date" func main() {
2、场景演示 当然说了这么多,我们在代码中常见的使用defer的场景有哪些呢?...6.3、服务器统一出错处理 现在呢我们就通过一个Http服务来展开如何统一处理服务器出错这件事,结合一个实际读取目录内文件的例子来简单介绍一下 func main() { http.HandleFunc...This is similar to the syntax accepted by godoc: go doc [....当然我们最常用的命令是 godoc ,我们help看一下它的基本用法 sheng$ godoc -help usage: godoc package [name ...]...同时还包含我们自己写的函数的文档,现在我们就演示一下 // 加法函数 func Add(a, b int32) int32 { return a + b } 我们在函数前面加上了注释,这是我们重新启动
,原来是因为阿粉的接口,是完全的依托于 Show-Doc 的服务器进行了发布,为了防止这种情况的出现,阿粉就开始研究关于 Show-Doc 如何在自己的电脑行搭建一个服务,这样如果 Show-Doc 网站再次升级的时候...,这时候就会出现,每个人写文档的风格不一致,有些人使用 Excel 有些人使用 Word 表格,有些人使用 Swagger 还有人使用 Show-Doc。...安装Show-Doc 上面这个图是需要你安装好本地服务之后,连接本地服务用的,也就是实际写文档的时候用的,搭建软件在下面呢。...下载网址(Windows下) Show-Doc 版本其实挺多的,因为阿粉之前的服务器已经到期了,我们就先整个 Windows 的版本来整一下,下载 Windows 版本。...但是不影响,启动了 Apache 的时候 Nginx 就算不管他,都能正常的使用,那阿粉就先留下这个坑,如果有问题,到时候再填上他。
领取专属 10元无门槛券
手把手带您无忧上云