go help
Go is a tool for managing Go source code.
Usage:
go <command> [arguments]
The commands are:
bug start a bug report
build compile packages and dependencies
clean remove object files and cached files
doc show documentation for package or symbol
env print Go environment information
fix update packages to use new APIs
fmt gofmt (reformat) package sources
generate generate Go files by processing source
get add dependencies to current module and install them
install compile and install packages and dependencies
list list packages or modules
mod module maintenance
run compile and run Go program
test test packages
tool run specified go tool
version print Go version
vet report likely mistakes in packages
Use "go help <command>" for more information about a command.
Additional help topics:
buildmode build modes
c calling between Go and C
cache build and test caching
environment environment variables
filetype file types
go.mod the go.mod file
gopath GOPATH environment variable
gopath-get legacy GOPATH go get
goproxy module proxy protocol
importpath import path syntax
modules modules, module versions, and more
module-get module-aware go get
module-auth module authentication using go.sum
module-private module configuration for non-public modules
packages package lists and patterns
testflag testing flags
testfunc testing functions
Use "go help <topic>" for more information about that topic.
go bug
go build [-o output] [-i] [build flags] [packages]
- 依据import导入路径，找到依赖，将依赖和包编译出来，此时不会安装。
- 如果要编译的源文件在一个单独的目录下，这个所有目录的都被会当成一个包的文件
- 编译会忽略"_test.go"结尾的文件
- 编译后的可执行文件名，可能是第一个源文件名，可能是目录名，后缀依平台而定
- 如果编译多个包或是一个非main包，不会产生可执行，仅仅作为检查包是否可以编译
- -o 选项可指定输出可执行的名字，当然包含的目录要存在
- -i 选项表示编译的同时，还安装
至于build flags， build/clean/get/install/list/run/test都用得上：
- -a 强制重新构建不是最新的包
- -n 打印命令，但不执行
- -p n 一个命令执行多个程序，n表示程序的数量。eg：通知执行test和build，并发。
- -race 启用竞争检测，只在64位系统上支持
- -msan 启用和内存清理的交互，64位系统，c编译器是clang/llvm时才支持
- -v 打印编译包的名字
- -work 打印临时目录名，退出时不自动删除
- -x 打印命令
- -asmflags '[pattern=]arg list'，go tool中传递的asm调用参数
- -buildmode mode，使用的构建模式
- -gccgoflags '[pattern=]arg list'
- -gcflags '[pattern=]arg list'
- -installsuffix suffix
- -ldflags '[pattern=]arg list'
- -linkshared
- -mod mode
- -pkgdir dir 指定包安装和加载的地址
- -tags tag,list
- -trimpath
- -toolexec 'cmd args'
看了下，大部分情况下都会用到上面的参数
go clean [clean flags] [build flags] [packages]
go doc [-u] [-c] [package|[package.]symbol[.methodOrField]]
这个和godoc还是有点不一样的，godoc会用h5来显示，go doc直接打印出结果
go env [-json] [-u] [-w] [var ...]
go fix [packages]
go fmt [-n] [-x] [packages]
go generate [-run regexp] [-n] [-v] [-x] [build flags] [file.go... | packages]
go get [-d] [-t] [-u] [-v] [-insecure] [build flags] [packages]
这个命令使用的非常频繁。
这个命令做得到第一件事添加依赖。
每个包都有一个版本号，类似 v1.1.1的tag， 如果没有tag，就找预发布版本，类似 v0.0.1-pre1, 如果这些都没有，就找最近一次提交。
如果依赖指明了具体的版本，就找指定版本，如果没有就取当前版本。
可以通过@来指定依赖的版本，eg：'go get golang.org/x/[email protected]'。
如果有源码管理工具，可能就有提交hash/分支标记/其他标记， 也可以使用'go get golang.org/x/text@master'，分支名不能重叠， eg：@v2指v2开头的版本，而不是v2分支。
指定一个版本@v1.1.1,目前依赖有两个版本v1.1.0和v1.1.3， 最后会选择v1.1.3，这里考虑到了向前兼容。
- -t 表示会运行包的测试文件
- -u 会更新依赖的版本
- -u=patch，表示使用release优先
这个命令做的第二件事就是下载依赖，构建/安装
go install [-i] [build flags] [packages]
可执行会丢在GOBIN下，就是GOPATH/bin。
不开启go module，会安装到GOBIN，开启go module，最后包会被构建， 被缓存，但不是安装。
- -i表示安装
go list [-f format] [-json] [-m] [list flags] [build flags] [packages]
这个命令非常有用，可显示指定包的依赖关系， 也可安装包分组来分析，目前有builtin和std两种。
go mod <command> [arguments]
go mod已经渗透到go命令的方方面面了。
commands包括：
- download 下载module到本地，进行缓存
- edit 编辑go.mod
- graph 显示模块的依赖图
- init 在当前目录初始化一个新的module
- tidy 添加遗失的模块信息，删除无用的模块信息
- vendor 制作第三方依赖的副本
- verify 校验依赖，是否完整正确
- why 解释为啥需要包或module,这个会解释哪个包用到了指定模块
go run [build flags] [-exec xprog] package [arguments...]
不安装，运行完之后，会自动将编译的文件删除掉。
go test [build/test flags] [packages] [build/test flags & test binary flags]
go test会先查找_test.go结尾的文件，这些文件里可能包含了测试函数， 基准测试函数，或是example函数。
_test.go文件会被单独编译成一个包，并链接，并和可执行二进制一起进行测试。
go tool会自动忽略一个叫testdata的目录，并从这个目录提取数据作为辅助数据， 给其他测试用。
go test 会先调用 go vet来查看是否有依赖确实的问题，如果有，就不会执行后面的了。 当然，这个go vet测试是可以关闭的。
测试结果和总结会输出到标准输出。
go test有两种运行方式：
- 本地目录方式
- 这种方式，运行命令中不带包信息，eg： go test -v .
- 不启用缓存
- 包列表方式
- go test命令中带了明确的包信息
- eg: go test ./...
- eg: go test math
只有在包列表模式下，才会启用缓存机制，如果使用了缓存，总结处会显示cached， 而不是花了多长时间。缓存匹配的条件是测试同一个可执行，flag都一样。
go tool [-n] command [args...]
go version [-m] [-v] [file ...]
go vet [-n] [-x] [-vettool prog] [build flags] [vet flags] [packages]
- cgo工具
- swig程序
GOCACHE，GODEBUG
- .go go源码
- .c .h c源码
- .cc .cpp .cxx .hh .hp .hxx c++源码
- .m objective-c源码
- .s .S 汇编源码
- .swig .swigcxx swig定义文件
- .syso 系统对象文件
用一个源码树来定义模块的版本，就是根目录下的go.mod文件。
go命令被执行时，首先会在当前目录下查找，之后去父目录查找， 找到了，那个目录就被称为main模块。
go.mod里注释是//开头，每一行就是一个指令，由动词+参数构成
动词如下：
- module，定义module路径
- go，指定golang预期版本
- require，要求使用指定版本，或比指定版本高的某个模块
- exclude，排除某个模块的特定版本
- replace，替换一个新的module版本
后两个动词，只用于main模块的go.mod,忽略依赖。 同一个动词是可以做"因式分解"的。 go.mod文件可以被直接编辑(go mod edit)，也可以由工具来更新。
执行go命令，每次都会自动更新go.mod
当启用go module时，解决导入就不需要和GOPATH强绑定了， 下载的源码还在GOPATH/pkg/mod下，安装依然在GOBIN
导入远程仓库，eg：github，导入本地包，可使用相对路径。
在指明import路径的同时，也可以指明版本管理工具,通过后缀：
- .git Git
- .svn Subversion
其他的版本控制工具也是类似的。
package math // import "path"
package math /* import "path" */
这是一个新特性，一个包有两个可能的导入路径
module就是相关包的集合，是源码导入和版本控制的最小单元。 module解决了依赖问题。v1.13就开始支持go module了
根目录下的go.mod用于定义module。从这个根目录开始，包括所有子目录， 都是这个module的内容，例外：某个子目录包含go.mod，就是一个新的。
go mod init github.com/interview
包含go.mod的目录，就是main module。
module中提供的包，称为构建列表 build list， 处死会话时只包含一个main module，go命令会更新。
用 go list就可以看到main module和build list
一般都是go命令自动维护
也就是go mod提出的"带语义的版本"，v1.0.2是常用的版本， v0.0.0-yyyymmddhhmmss-abcdefabcdef 就是伪版本，也需要支持， 总的来说，有以下几种：
- vX.0.0-yyyymmddhhmmss-abcdefabcdef
- vX.Y.Z-pre.0.yyyymmddhhmmss-abcdefabcdef
- vX.Y.(Z+1)-0.yyyymmddhhmmss-abcdefabcdef
v1.2.3是一个完全语义的版本， v1,v1.2就是一个带前缀的语义版本，前缀需要去做匹配， 语义版本是支持比较的，"<v1.1.1",">=v2.2.1"。
latest可以匹配最后一个tagged版本，或者是没有tagged的最后一个版本。
upgrade和latest类似，不过upgrade是取下一个版本，而不是最后一个版本。
patch，匹配最后一个tagged版本，major/minor都匹配，然后取最后一个patch， 如果没有指定版本，patch就等于latest。
语义匹配一般有提交的hash，tag/分支名，发布版本。 tag/分支名的匹配规则是另一套，所以v2匹配上的是发布版本，而不是分支名等。 所有的查询优先匹配前一个release版本，"<v1.1.1",会匹配"v1.1.0", 而不是"v1.1.1-pre1".
要求module在一个大版本里是兼容的，不兼容的用另一个大版本
go test 带两类参数，一类给go test自己用，一类给结果用。
具体的测试用例可包含单元测试/基准测试/例子