常用命令

  2. 1. build 编译包和依赖项
  4. 2. clean 删除对象文件和缓存的文件
  6. 3. doc与godoc 显示包文档
  8. 4. env 打印Go语言的环境信息
  10. 5. fix与go tool fix 会把指定包中的所有Go语言源码文件中旧版本代码修正为新版本的代码,升级版本时非常有用
  12. 6. fmt与gofmt 格式化go源文件
  14. 7. generate
  16. 8. get 下载并安装包和依赖(下载包和依赖,并对它们进行编译安装)
  18. 9. install 编译并安装指定包及它们的依赖包,
  20. 10. list 列出包和模块信息
  22. 11. mod 管理模块
  24. 12. run 编译并运行Go程序
  26. 13. test 测试包
  28. 14. tool 运行指定的go工具
  30. 15. version 查看当前go语言版本
  32. 16. vet 报告包中可能出现的错误

build 编译包和依赖项

  2. build 编译包和依赖项
  4. usage: go build [-o output] [-i] [build flags] [packages]
  6. 用法:  go build [-o output] [-i] [build 参数] [包]
  8. 可选参数:
  10.     -o 编译单个包才能使用(不能同时对多个代码包进行编译),例如我们经常重新命名可执行文件名字
  12.     -i 标志安装的包是目标的依赖项
  14.     -a 强制重新构建已经更新的包
  16.     -n 打印编译时执行的命令,但不真正执行
  18.     -p 开启并发编译,默认情况下该值为CPU逻辑核数
  20.     -race 开启竞态检测,只支持linux/amd64、freebsd/amd64、darwin/amd64和windows/amd64.
  22.     -msan 内存扫描
  24.     -v 编译包时打印包的名称
  26.     -work 编译时打印临时工作目录的名称,退出时不删除它
  28.     -x 打印编译时执行的命令(打印编译时会用到的所有命令)
  30.     -asmflags '[pattern=]arg list',传递给每个go工具asm调用的参数
  32.     -buildmode mode 使用编译模式, 更多信息请参见“go help buildmode”
  34.     -compiler name 设置编译时使用编译器名,编译器名称只有2个选项(gccgo或gc)
  36.     -gccgoflags '[pattern=]arg list' 传递每个gccgo编译器/链接器调用的参数列表
  38.     -gcflags '[pattern=]arg list' 用于指定需要传递给go tool compile命令的参数的列表,更多信息参见(go tool compile)
  40.     -installsuffix suffix 为了使当前的输出目录与默认的编译输出目录分离,可以使用这个标记.此标记的值会作为结果文件的父目录名称的后缀.其实,如果使用了-race标记,这个标记会被自动追加且其值会为race.如果我们同时使用了-race标记和-installsuffix,那么在-installsuffix标记的值的后面会再被追加_race,并以此来作为实际使用的后缀
  42.     -ldflags '[pattern=]arg list' 用于指定需要传递给go tool link命令的参数的列表
  44.     -linkshared
  46.     -mod mode 模块下载方式,只有2个选项(readonly或vendor),更多信息请参见(go help modules)
  48.     -pkgdir dir 设置包目录.编译器会只从该目录中加载代码包的归档文件,并会把编译可能会生成的代码包归档文件放置在该目录下
  50.     -tags 'tag list'
  52.     -toolexec 'cmd args' 用于在编译期间使用一些Go语言自带工具(如vet、asm等)的方式
  54. 示例:
  56. go build [1个或多个go源文件, 或者包名, 或者包所在目录]
  58. go build a.go b.go main.go
  60. go build main.go
  62. go build hello
  64. # 把main.go编译成可执行文件hello.exe
  66. go build -o hello.exe  main.go
  68. # 打印编译时执行的命令,但不真正执行
  70. go build -n
  72. # 答应工作目录
  74. go build -work

clean 删除对象文件和缓存的文件

  2. clean 删除执行其他命令时产生的文件、目录和缓存文件.
  4.     具体地说.clean 会删除从导入路径对应的源码目录中,删除以下这些文件和目录
  6.         _obj/            old object directory, left from Makefiles
  8.         _test/          old test directory, left from Makefiles
  10.         _testmain.go    old gotest file, left from Makefiles
  12.         test.out        old test log, left from Makefiles
  14.         build.out        old test log, left from Makefiles
  16.         *.[568ao]        object files, left from Makefiles
  18.         DIR(.exe)        from go build
  20.         DIR.test(.exe)  from go test -c
  22.         MAINFILE(.exe)  from go build MAINFILE.go
  24.         *.so            from SWIG
  26. usage: go clean [clean flags] [build flags] [packages]
  28.   用法: go clean [clean 参数]  [build参数]  包
  30.   可选参数:
  32.     -i 会删除安装当前代码包所有产生的所有文件, 如果当前包是一个普通包(不是main包),则结果文件指的就是在工作区的pkg目录的相应目录下的归档文件.如果当前代码包中只包含一个命令源码文件, 则删除当前目录和在工作区的bin目录下的可执行文件和测试文件.
  34.     -n 打印clean执行的命令,但不真正执行
  36.     -r 删除当前代码包和所有的依赖包产生的文件、目录和缓存文件
  38.     -x 打印clean执行的删除命令
  40.     -cache 删除所有 go build 的缓存
  42.     -testcache 删除当前包所有的测试结果

doc 显示包文档

  2. doc与godoc 显示包或符号的文档, 更多用法请参考(godoc -h)
  4. usage: go doc [-u] [-c] [package|[package.]symbol[.methodOrField]]
  6. 用法:  go doc [-u] [-c] [package|[package.]symbol[.methodOrField]]
  8. 可选参数:
  10.     -c 区分参数包名的大小写.默认情况下,包名是大小写不敏感的
  12.     -cmd 打印 main 包文档, 默认情况下不会打印 main 包文档
  14.     -u 打印出所有的文档(同事包含可导出和不可导出实体)
  16. 示例:
  18. # 显示 hellomod 包文档,(注意 hellomod 和 Hellomod是不同的包)
  20. go doc -c hellomod

env 打印Go语言的环境信息

  2. env 打印Go语言的环境信息
  4. usage: go env [-json] [var ...]
  6. 用法: go env [-json] [变量 ...]
  8. 可选参数:
  10.     -json 以json格式打印环境信息
  12. 示例:
  14. # 以json格式打印所有环境信息
  16. go env -json
  18. # 以json格式只打印 GOOS 程序构建环境的目标操作系统
  20. go env -json GOOS
  22. # 打印所有环境信息
  24. go env
  26. # 只打印 GOOS 程序构建环境的目标操作系统
  28. go env GOOS

fix与go tool fix 会把指定包中的所有Go语言源码文件中旧版本代码修正为新版本的代码,升级版本时非常有用

  2. fix 会把指定包中的所有Go语言源码文件中旧版本代码修正为新版本的代码
  4. usage: go fix [packages]
  6. 示例:
  8. go fix testmod
  10. go tool fix -h
  12. usage: go tool fix [-diff] [-r fixname,...] [-force fixname,...] [path ...]
  14.     -diff 不将修正后的内容写入文件, 而只打印修正前后的内容的对比信息到标准输出
  16.     -force string 使用此参数后, 即使源码文件中的代码已经与Go语言的最新版本相匹配, 也会强行执行指定的修正操作.该参数值就是需要强行执行的修正操作的名称,多个名称之间用英文半角逗号分隔
  18.     -r string 只对目标源码文件做有限的修正操作.该参数的值即为允许的修正操作的名称.多个名称之间用英文半角逗号分隔

fmt与gofmt 格式化go源文件

Go 开发团队不想要 Go 语言像许多其它语言那样总是在为代码风格而引发无休止的争论,浪费大量宝贵的开发时间,因此他们制作了一个工具:go fmt（gofmt）

  2. fmt与gofmt 命令 格式化go源文件,fmt命令实际"gofmt -l -w"命令之上做了一层包装,我们一般使用
  4. usage: go fmt [-n] [-x] [packages]
  6. 用法: go fmt [-n] [-x] 包
  8. 可选参数:
  10.     -x 打印执行的命令
  12.     -n 打印执行的命令,但不真正执行
  14. 示例:
  16. # 格式化 testmod 包, 并显示执行命令
  18. go fmt -x testmod
  20. gofmt 命令
  22. usage: gofmt [flags] [path ...]
  24. 用法: gofmt [参数] [路径 ...]
  26. 可选参数:
  28.     -cpuprofile string 将cpu配置文件写入此文件
  30.     -d 显示格式化前后差异,但不写入文件
  32.     -e 打印所有错误, 默认只会打印不同行的前10个错误
  34.     -l 列出需要格式化的文件
  36.     -r string 重新规则,方便我们做批量替换,例如我们需要把hellomod.Hello替换成hellomod.HelloNew("hellomod.Hello -> hellomod.HelloNew")
  38.     -s 简化代码
  40.     -w 将结果直接写入到文件中
  44. 示例:
  46. # 格式当前目录代码
  48. gofmt -w ./
  50. # 把当前目录中的“hellomod.Hello” 替换成 "hellomod.HelloNew"
  52. gofmt -r "hellomod.Hello -> hellomod.HelloNew" -w ./

get 下载并安装包和依赖(下载包和依赖,并对它们进行编译安装)

  2. get 命令 下载并安装包和依赖(下载包和依赖,并对它们进行编译安装)
  4. usage: go get [-d] [-f] [-t] [-u] [-v] [-fix] [-insecure] [build flags] [packages]
  6. 用法: go get [-d] [-f] [-t] [-u] [-v] [-fix] [-insecure] [build flags] [包]
  8. 可选参数:
  10.     -d 只下载不安装(只执行下载动作, 不执行安装动作)
  12.     -f 只有在包含了-u参数的时候才有效.该参数会让命令程序忽略掉对已下载代码包的导入路径的检查.如果下载并安装的代码包所属的项目是你从别人那里Fork过来的,那么这样做就尤为重要了
  14.     -fix 会下载代码包后先执行修正动作,而后再进行编译和安装
  16.     -insecure 请谨慎使用, 允许使用不安全(http或者自定义域)的存储库中下载解析.
  18.         即:允许命令程序使用非安全的scheme（如HTTP）去下载指定的代码包.如果你用的代码仓库(如公司内部的Gitlab)没有HTTPS支持,可以添加此标记.请在确定安全的情况下使用它.
  20.     -t 同时也下载需要为运行测试所需要的包
  22.     -u 强制从网络更新包和它的依赖包.默认情况下,该命令只会从网络上下载本地不存在的代码包,而不会更新已有的代码包
  24.     -v 显示执行的命令
  26. 示例:
  28. # 下载包
  30. go get github.com/donvito/hellomod

install 编译并安装指定包及它们的依赖包

  2. install 编译并安装指定包及它们的依赖包,先生成中间文件(可执行文件或者.a包),然后把编译好的结果移到$GOPATH/pkg或者$GOPATH/bin
  4. usage: go install [-i] [build flags] [packages]
  6. 用法: go install [-i] [编译 flags] [包]
  8. 可选参数:
  10.     -i
  12. 示例:
  14. # 安装包
  16. go install github.com/gin-gonic/gin

list 列出包和模块信息

  2. list 列出包和模块信息
  4. usage: go list [-f format] [-json] [-m] [list flags] [build flags] [packages]
  6. 用法: go list [-f format] [-json] [-m] [list flags] [build flags] [包]
  8. 可选参数:
  10.     -f {{.字段名}} 查看指定的字段信息
  12.     -json 以json格式打印信息
  14.     -m 列出模块信息
  16. 更多用法请参考(go help list)
  18. 示例:
  20. # 以json格式打印gapp包信息
  22. go list -json gapp
  24. # 打印模块信息
  26. go list -m testmod
  28. # 以json格式打印模块信息
  30. go list -m -json testmod
  32. # testmod模块打印结果:
  34. {
  36.         "Path": "testmod",
  38.         "Main": true,
  40.         "Dir": "/Users/zhaoweijie/go/src/business-card/docker-compose/go-tutorials/9/examples/testmod",
  42.         "GoMod": "/Users/zhaoweijie/go/src/business-card/docker-compose/go-tutorials/9/examples/testmod/go.mod"
  44. }

mod 管理模块

  2. mod 管理模块
  4. Usage: go mod <command> [arguments]
  6. 用法: go mod <命令> [参数]
  8. 可选命令<command>: go help mod <command>
  10.     download    下载模块到本地缓存
  12.         usage: go mod download [-json] [modules]
  14.           用法:
  16.         可选参数:
  18.             -json
  20.         示例:
  22.             # 下载模块,以json格式打印模块信息
  24.             go mod download -json github.com/qq1060656096/hellomod 
  26.             # json格式打印 github.com/qq1060656096/hellomod 模块信息
  28.             {
  30.                     "Path": "github.com/qq1060656096/hellomod",
  32.                     "Version": "v1.0.0",
  34.                     "Info": "/Users/zhaoweijie/go/pkg/mod/cache/download/github.com/qq1060656096/hellomod/@v/v1.0.0.info",
  36.                     "GoMod": "/Users/zhaoweijie/go/pkg/mod/cache/download/github.com/qq1060656096/hellomod/@v/v1.0.0.mod",
  38.                     "Zip": "/Users/zhaoweijie/go/pkg/mod/cache/download/github.com/qq1060656096/hellomod/@v/v1.0.0.zip",
  40.                     "Dir": "/Users/zhaoweijie/go/pkg/mod/github.com/qq1060656096/hellomod@v1.0.0",
  42.                     "Sum": "h1:O66u/mTlM4cHHdwuKPNpUBmJor2XOv0Wa0j+qfOwAN4=",
  44.                     "GoModSum": "h1:TOAQUVNcJP1uykhVNbIcfTsdYdjs2zrIYEtpAGWpcqg="
  46.             }
  48.     edit  提供命令来编辑go.mod文件, 主要用于工具或脚本
  50.         usage: go mod edit [editing flags] [go.mod]
  52.         用法: go mod edit [editing flags] [go.mod]
  54.         可选参数:
  56.             -fmt 只会格式化go.mod文件
  58.             -module 更改模块路径
  60.             -require=path@version 添加模块依赖
  62.                 示例:
  64.                     # 添加hellomod模块v1.0.0版本
  66.                     go mod edit -require=github.com/qq1060656096/hellomod@v1.0.0
  68.             -droprequire=path 删除模块依赖
  70.                 示例:
  72.                     # 删除hellomod模块
  74.                     go mod edit -droprequire=github.com/qq1060656096/hellomod
  76.             -exclude=path@version 排查模块
  78.                 # 排除hellomod模块v1.0.0版本
  80.                 go mod edit -exclude=github.com/qq1060656096/hellomod@v1.0.0
  82.             -dropexclude=path@version 删除排除的模块(恢复排除的模块)
  84.                 # 恢复排除hellomod模块v1.0.0版本
  86.                 go mod edit -dropexclude=github.com/qq1060656096/hellomod@v1.0.0
  88.             -replace=old[@v]=new[@v] 替换模块
  90.                 示例:
  92.                     # hellomod模块v1.0.0版本替换成v2.0.0版本
  94.                     go mod edit -replace=github.com/qq1060656096/hellomod@v1.0.0=github.com/qq1060656096/hellomod@v2.0.0
  96.             -dropreplace=old[@v]
  98.             -print 打印结果,不会操作go.mod文件
  100.             -json 以json格式打印结果,不会操作go.mod文件
  102.     graph  打印模块需求图
  104.         usage: go mod graph
  106.         用法: go mod graph
  108.     init    在当前⽂件夹下初始化⼀个新的模块(创建go.mod⽂件)
  110.         usage: go mod init [module]
  112.         用法: go mod init [模块名]
  114.         示例:
  116.             # 创建“github.com/qq1060656096/hellomod”模块
  118.             go mod init github.com/qq1060656096/hellomod
  120.     tidy    整理模块(增加缺少的模块,删除未⽤的模块)
  122.         usage: go mod tidy [-v]
  124.         用法: go mod tidy [-v]
  126.         可选参数:
  128.             -v 打印已经删除的模块信息
  130.         示例:
  132.             # 整理模块,并打印已经删除的模块
  134.             go mod tidy -v
  136.     vendor  将依赖复制到vendor下
  138.         usage: go mod vendor [-v]
  140.         用法: go mod vendor [-v]
  142.         可选参数:
  144.             -v 打印复制到vendor的所有包和模块
  146.         示例:
  148.             # 打印复制到vendor的所有包和模块
  150.             go mod vendor -v
  152.     verify  校验依赖的HASH码,验证检查当前模块的依赖, 如果依赖本有更改就使用之前的, 如果所有模块都没有更改,就打印"all modules verified
  154. ", 否则就报告(打印)已更改的模块
  156.         usage: go mod verify
  158.         用法: go mod verify
  160.         示例:
  162.             go mod verify
  164.     why    解释为什么需要依赖
  166.         usage: go mod why [-m] [-vendor] packages...
  168.         用法: go mod why [-m] [-vendor] packages...
  170.         可选参数
  172.             -vendor
  174.             -m

run 编译并运行Go程序

  2. run 命令 编译并运行Go程序
  4. usage: go run [build flags] [-exec xprog] package [arguments...]
  6. 用法: go run [编译 flags] [-exec xprog] 包 [arguments...]
  8. 可选参数: 其他参数请参考(go help build)
  10.     -exec
  12. 示例:
  14. # 运行maing.go
  16. go run main.go
  18. # 运行maing.go并开启竞态检测(开发时建议开启这个选项)
  20. go run -race main.go

test 测试包

  2. go test 用于测试包
  4. usage: go test [build/test flags] [packages] [build/test flags & test binary flags]
  6.     -c 把包编译二进制测试包, 注意不会运行, 需要你手动执行二进制测试
  8.         示例:
  10.             go test -c package_import_path
  12.             go test -c 包的导入路径
  14.             1. go test -c 在当前目录生成二进制测试
  16.             2. go test -c go test -c go-tutorials/8/examples/demo1
  18.     -exec 运行二进制测试
  20.         示例:
  22.             go test -c -exec demo1.test
  24.     -json 运行测试,并将结果输出为json格式
  26.         示例:
  28.             go test -json path
  30.             1. go test -json 测试当前包
  32.             2. go test -json ./
  34.     -o 把测试编译成自己命名二进制包, 默认仍然会运行测试(除非指定-c或者-i)
  36.         示例:
  38.             go test -o file_name
  40.             go test -o 文件名
  42.             1. go test -o demo1.custom_name.test
  44.     -bench 运行基准测试, 默认情况下不运行
  46.         示例:
  48.             go test -bench regexp
  50.             go test -bench 正则表达式
  52.             1. go test -bench 运行所有基准测试
  54.             2. go test -bench=. 运行所有基准测试
  56.             3. go test -bench=hah 运行指定的基准测试
  58.     -benchtime 基准测试,持续时间(默认1秒)
  62.     -count 运行测试次数
  64.         示例:
  66.             go test -count n
  68.             go test -count 次数
  70.             1. go test -count 10 运行所有的测试10次
  72.     -cover 覆盖率统计, 注意覆盖率统计是通过代码注释来工作的
  74.     -cpu 指定测试cpu数量
  76.         示例:
  78.             go test -cpu 1,2,4
  80.             go test -cpu cpu数量
  82.             1. go test -cpu 8 指定8个cpu
  84.     -list regexp 列出匹配的测试
  86.         示例:
  88.             go test -list regexp
  90.             go test -list 正则表达式
  92.             1. go test -list Login 列出demo1中的测试
  94.     -v 详细输出运行时记录所有的测试
  96.         示例:
  98.             go test -v

tool 运行指定的go工具

  2. tool 命令 运行指定的go工具
  4. usage: go tool [-n] command [args...]
  6. 用法: go tool [-n] 命令 [args...]
  8. 可选参数:
  10.     -n 打印要执行的命令, 但是不真正的执行
  12. 示例:
  14. # 打印vet工具执行的命令
  16. go tool -n vet

go tool 工具列表 

  2. # go tool: 列表工具列表
  4. # go tool 工具 -h: 查看工具帮助文档
  6. # 查看vet工具帮助文档: go tool vet -h
  8. addr2line
  10. api
  12. asm
  14. buildid
  16. cgo
  18. compile
  20. cover
  22. dist
  24. doc
  26. fix
  28. link
  30. nm
  32. objdump
  34. pack
  36. pprof 可以帮助开发者快速分析及定位各种性能问题,如 CPU 消耗、内存分配及阻塞分析
  38. test2json
  40. trace
  42. vet 报告包中可能出现的错误,开发时建议使用这个工具(fmt printf函数参数不对或者声明结构体 tag声明不对等)

version 查看当前go语言版本

  2. version 查看go当前的版本
  4. usage: go version
  6. 示例:
  8. # 查看go当前的版本
  10. go version

vet 报告包中可能出现的错误

  2. vet 静态检查工具,报告包中可能出现的错误, 开发时建议使用这个工具(fmt printf函数参数不对或者声明结构体 tag声明不对等)
  4. usage: go vet [-n] [-x] [build flags] [vet flags] [packages]
  6. 用法: go vet [-n] [-x] [编译参数] [vet flags] [包]
  8. 可选参数:
  10.     -n 打印要执行的命令, 但是不真正的执行
  12.     -x 打印执行的命令
  14. 更多参数请参考(go help build)
  16. 示例:
  18. # 检测 testmod 包中可能存在的问题
  20. go vet testmod