go命令工具

发布于:2023-02-02 ⋅ 阅读:(729) ⋅ 点赞:(0)

官方工具

go get

该命令可以根据要求和实际情况从互联网上下载更新指定的代码包及其依赖包,下载后自动编译,一般引用依赖用go get就可以了。

go build

该命令用于编译我们指定的源码文件或代码包 以及 它们的依赖包。
命令的常用 命令参数 如下:

命令参数 说明
-o 重命名 编译 之后的文件名称,默认是 go.mod 中的模块名
-a 强行对 所有涉及到的 代码包 进行 重构
-n 打印编译期间 所用到的 其他命令,但是不真正的执行他们
-x 打印编译期间 所用到的 其他命令,和 -n是有区别的
-p n 编译过程中 所需要 执行各个任务的 并行数量, n 默认是 CPU的核心数
-v 打印出哪些被编译的代码包的名字
–race 开启竞态条件的检测
–work 打印出编译时生成的临时工作目录的路径,并在编辑结束后保留它。默认情况下是不会保留临时工作的

go install

install 是 安装的意思, 有点迷惑人,其实
该命令用于编译安装指定的代码包及它们的依赖包。
当指定的代码包的依赖包还没有被编译和安装时,该命令会先去处理依赖包。
与go build命令一样,传给go install命令的代码包参数应该以导入路径的形式提供。
实际上,go install命令只比go build命令多做了一件事,即:安装编译后的结果文件到指定目录($GOBIN)。

go fmt

格式化目录中所有.go文件

go env

打印Go语言的环境信息,
常见的通用环境信息如下:

名称 说明
CGO_ENABLED 指明 cgo工具是否可用 的标识
GOARCH 电脑系统架构
GOBIN 存放 可执行文件 的目录 的 绝对路径
GOOS 操作系统
GOPATH 工作区 目录的绝对路径
GOROOT go安装包的 安装目录的绝对路径
GOTOOLDIR go工具目录的绝对路径
GOPROXY 拉取依赖的代理
GOSUMDB 用来校验下载的包的安全性问题
  • 使用Go env命令设置Go的环境
# 永久有效
go env -w GO111MODULE=on

go run

该命令可以运行命令源码文件,只能接受一个命令源码文件以及若干个库源码文件(必须同属于main包)作为文件参数,且不能接受测试源码文件。它在执行时会检查源码文件的类型。如果参数中有多个或者没有命令源码文件,那么go run命令就只会打印错误提示信息并退出,而不会继续执行。
在通过参数检查后,go run命令会将编译参数中的命令源码文件,并把编译后的可执行文件存放到临时工作目录中。

go test

用于对Go语言编写的程序进行测试

go clean

该命令会删除掉执行其它命令时产生的一些文件和目录。

go list

该命令的作用是列出指定的代码包的信息。与其他命令相同,我们需要以代码包导入路径的方式给定代码包。被给定的代码包可以有多个。这些代码包对应的目录中必须直接保存有Go语言源码文件,其子目录中的文件不算在内。
标记-e的作用是以容错模式加载和分析指定的代码包。在这种情况下,命令程序如果在加载或分析的过程中遇到错误只会在内部记录一下,而不会直接把错误信息打印出来。
为了看到错误信息可以使用-json标记。这个标记的作用是把代码包的结构体实例用JSON的样式打印出来。-m标记可以打印出modules而不是package。

go list -json -m

{
        "Path": "github.com/Project/test",
        "Main": true,
        "Dir": "/data/test",
        "GoMod": "/data/test/go.mod",
        "GoVersion": "1.15"
}

go mod ***

go mod init

该命令初始化并写入一个新的go.mod至当前目录中,实际上是创建一个以当前目录为根的新模块。文件go.mod必须不存在。如果可能,init会从import注释(参阅“go help importpath”)或从版本控制配置猜测模块路径。要覆盖此猜测,提供模块路径作为参数 module为当前项目名。

go mod tidy

该命令确保go.mod与模块中的源代码一致。它添加构建当前模块的包和依赖所必须的任何缺少的模块,删除不提供任何有价值的包的未使用的模块。它也会添加任何缺少的条目至go.mod并删除任何不需要的条目。

go mod download

该命令下载指定名字的模块,可为选择主模块依赖的模块匹配模式,或path@version形式的模块查询。如果download不带参数则代表是主模块的所有依赖。download的只会下载依赖,不会编译依赖,和get是有区别的。

go mod vendor

该命令重置主模块的vendor目录,使其包含构建和测试所有主模块的包所需要的所有包。不包括vendor中的包的测试代码。即将GOPATH或GOROOT下载的包拷贝到项目下的vendor目录,如果不使用vendor隔离项目的依赖,则不需要使用该命令拷贝依赖。

go mod edit

该命令提供一个编辑go.mod的命令行接口,主要提供给工具或脚本使用。它只读取go.mod;不查找涉及模块的信息。默认情况下,edit读写主模块的go.mod文件,但也可以在标志后指定不同的目标文件。

go mod graph

该命令以文本形式打印模块间的依赖关系图。输出的每一行行有两个字段(通过空格分割);模块和其所有依赖中的一个。每个模块都被标记为path@version形式的字符串(除了主模块,因其没有@version后缀)。

go mod verify

该命令查存储在本地下载源代码缓存中的当前模块的依赖,是否自从下载之后未被修改。如果所有模块都未被修改,打印“all modules verified”。否则,报告哪个模块已经被修改并令“go mod”以非0状态退出。

go mod why

该命令输出每个包或者模块的引用块,每个块以注释行“# package”或“# module”开头,给出目标包或模块。随后的行通过导入图给出路径,一个包一行。每个块之间通过一个空行分割,如果包或模块没有被主模块引用,该小节将显示单独一个带圆括号的提示信息来表明该事实。

go tool ***

go tool的可执行文件在GOROOT或GOPATH的pkg/tool目录。
go doc cmd可以查看具体cmd的使用说明,比如:go doc pprof

go tool pprof

在Golang中,可以通过pprof工具对应于程序的运行时进行性能分析,包括CPU、内存、Goroutine等实时信息。

go tool trace

该命令可以追踪请求链路,清晰的了解整个程序的调用栈,可以通过追踪器捕获大量信息。

go tool compile

该命令可以编译Go文件生成汇编代码,-N参数表示禁止编译优化, -l表示禁止内联,-S表示打印汇编,比如

go tool compile -S main.go # 会生成main.o的汇编文件

go tool vet

该命令是一个用于检查Go语言源码中静态错误的简单工具。

go tool doc

该命令可以打印附于Go语言程序实体上的文档。我们可以通过把程序实体的标识符作为该命令的参数来达到查看其文档的目的。
所谓Go语言的程序实体,是指变量、常量、函数、结构体以及接口。而程序实体的标识符即是代表它们的名称。

go tool addr2line

该命令可以调用栈的地址转化为文件和行号。

go tool asm

该命令可以将汇编文件编译成一个.o文件,后续这个.o文件可以用于生成.a归档文件,命令的file参数必须是汇编文件

go tool buildid

每一个 Go 二进制文件内,都有一个独一无二的 Build ID

go tool cgo

该命令可以使我们创建能够调用C语言代码的Go语言源码文件。这使得我们可以使用Go语言代码去封装一些C语言的代码库,并提供给Go语言代码或项目使用。

go tool cover

该命令对单元测试过程中生成的代码覆盖率统计生成html文件,可以本地打开展示。

go test -coverprofile=a.out
go tool cover -html=a.out -o coverage.html

覆盖度工具不仅可以记录分支是否被执行,还可以记录分支被执行了多少次。
go test -covermode=set|count|atomic: -covermode:
set: 默认模式,统计是否执行
count: 计数
atomic: count的并发安全版本,仅当需要精确统计时使用
通过go tool cover -func=count.out查看每个函数的覆盖度。

go tool dist

dist工具是属于go的一个引导工具,它负责构建C程序(如Go编译器)和Go工具的初始引导副本。它也可以作为一个包罗万象用shell脚本替换以前完成的零工。通过“go tool dist”命令可以操作该工具。

go tool fix

该命令会把指定代码包的所有Go语言源码文件中的旧版本代码修正为新版本的代码。这里所说的版本即Go语言的版本。代码包的所有Go语言源码文件不包括其子代码包(如果有的话)中的文件。修正操作包括把对旧程序调用的代码更换为对新程序调用的代码、把旧的语法更换为新的语法等等。
这个工具其实非常有用。在编程语言的升级和演进的过程中,难免会对过时的和不够优秀的语法及标准库进行改进。

go tool link

该命令链接Go的归档文件比如静态库,以及链接其所有依赖,生成一个可执行文件(含main package)。

go tool nm

该命令可以查看符号表的命令,等同于系统的nm命令,非常有用。在断点的时候,如果你不知道断点的函数符号,那么用这个命令查一下就知道了(命令处理的是二进制程序文件),第一列是地址,第二列是类型,第三列是符号。等同于nm命令。

go tool objdump

该命令可以反汇编二进制的工具,等同于系统objdump,命令解析的是二进制格式的程序文件。

go tool pack

该命令把二进制文件打包成静态库。

go tool test2json

该命令用于把测试可执行文件转化可读的json格式。

godoc

该命令可以生成一个Go官方文档的本地http服务,可以在线查看标准库和第三方库文档,以及项目文档,但是需要按照一定的格式去写注释。

// 安装godoc
go get -v  golang.org/x/tools/cmd/godoc
 
// 方式一
godoc -http=:6060
 
// 方式二 :-play可以使用playground运行Example代码
godoc -http=:6060 -play
 
// 查看自己的项目文档,需要将其它路径下的项目代码目录建一个软链到GOROOT的src目录下,如cd $GOROOT/src; ln -s /data/my-project ./,在浏览器后面输入项目名即可
http://127.0.0.1:6060/pkg/my-project/

三方命令工具

delve

本地代码调试工具, 详情

goleak

本地排查内存泄露的工具, 详情

go-wrk

Go接口压测工具,详情

gops

查看go进程和相关信息的工具,用于诊断线上服务。详情

goreplay

GoReplay是一个开源网络监控工具,可以将实时HTTP流量捕获并重放到测试环境。详情

depth

一个有用的Golang工具,Depth可帮助Web开发人员检索和可视化Go源代码依赖关系树。它可以用作独立的命令行应用程序或作为项目中的特定包。你可以通过在解析之前在Tree上设置相应的标志来添加自定义。详情

go-swagger

该工具包包括各种功能和功能。Go-Swagger是Swagger 2.0的一个实现,可以序列化和反序列化swagger规范。它是RESTful API简约但强大的代表。详情

gotype

gotype会对go文件和包进行语义(semantic)和句法(syntactic)的分析,这是google提供的一个工具。详情