[Golang] Go 常用命令
[golang] Go 常用命令
以下是开发过程会涉及的常用命令。
go run
编译生成临时可执行文件,程序结束后删除。适合用于小程序的调试,或者把 Go 当成脚本语言来用的场景。
go build
编译并生成可执行文件,默认与源码文件同名,可通过 -o
指定名称。
go install
Go 程序除了可通过预先编译成可执行文件进行分发外,常用的工具包等三方依赖,通常以源码的形式进行分发。
使用者通过 go install
来获取,该命令接收一个指向源码的仓库地址,以 @
加上版本号结尾。
如果想使用最新的版本,则写 @latest
。
示例:
$ go install github.com/foo/bar@latest
该命令实际上包含了如下过程:
- 下载源码
- 编译生成可执行文件
- 安装到
$GOPATH/bin
目录
而更新操作也是一样的,重新执行一次安装即可。
代码格式化
Go 自带了格式化命令 go fmt
,
$ go fmt path/to/your/package
同时也提供了一个增强工具 goimports 用于格式化 import 导入。
安装:
$ go install golang.org/x/tools/cmd/goimports@latest
使用:
$ goimports -l -w .
代码风格检查
使用 golint
对代码进行检查,安装如下:
$ go install golang.org/x/lint/golint@latest
假设目前项目中只有一个 main.go
的文件,其内容如下:
package main
import (
"fmt"
)
func main() {
a := 1
fmt.Println("hello world!")
}
使用:
# Lint 整个项目
$ golint ./…
不过,实测发现即使代码格式有问题,执行上述命令后,golint
什么也没输出,尝试后发现加上 -min_confidence 0
参数后就有输出了,
$ golint -min_confidence 0 ./...
main.go:1:1: should have a package comment, unless it's in another file for this package
另外还有些代码错误语法合格是 Lint 检查不到的,譬如传递了错误数量的参数给方法,变更定义后未使用等,可用 go vet
命令来检查此类问题。
$ go vet ./…
vet: ./main.go:8:1: a declared but not used
golangci-lint 是一个集成了 golint
,go vet
以及其他一些三方保证代码质量的工具,安装后一次运行该命令即可。
$ golangci-lint run
Makefile
开发过程需要重复执行一些操作,比如上面的 lint,fmt 以及编译等,人工操作未免烦杂,利用 Linux 世界的 Make 可以将这些动作写到 makefile 中,后续执行 make
命令即可自动完成。
一个简单的示例:
# makefile
.DEFAULT_GOAL:= build
fmt:
go fmt ./...
.PHONY:fmt
lint:
golint ./..
.PHONY:lint
vet:fmt
go vet ./...
.PHONY:vet
build:vet
go build main.go
.PHONY:build
如果你已经熟悉 makefile,上面代码不言自明。
如果未了解过,其中冒号前面定义了一个任务或者叫 target,执行 make
命令时可指定具体的 target。
其中 .DEFAULT_GOAL
定义默认任务,即,在没有指定任务名时运行的任务。
冒号后面是该任务的依赖,表示需要依赖先执行完才行。
紧跟任务的行定义该任务具体要执行的命令。
而 .PHONY
部分的作用,可以避免如果项目中有与任务名同名文件夹时,产生冲突的问题。
有了上面定义好的 makefile,就可以执行 make
命令了,
$ make
go fmt ./...
go vet ./...
# example.com/hello
vet: ./main.go:8:2: a declared but not used
make: *** [vet] Error 2
Go 版本更新
Go 编译后的程序不依赖运行时,所以不受 Go 版本的影响。但源码的编译是和版本有关的。
一般情况下,不会有向后兼容性问题,但升级正确的做法,还是先安装新版,在新版下验证程序后再正式将 Go 的版本切换到新版。
以当前 1.16.1
升级到 1.16.5
为例:
$ go et golang.org/dl/go.1.16.5
$ go1.16.5 download
然后使用新版编译程序进行验证:
$ go1.16.5 build
验证通过后即可将新版的环境变量删除,
$ go1.16.5 env GOROOT
/Users/gobook/sdk/go1.16.5
$ rm -rf $(go1.16.5 env GOROOT)
$ rm $(go env GOPATH)/bin/go1.16.5
然后安装最新 Go 版本即可。如果之前通过 Homebrew 安装,则仍然使用它升级即可。