Go官方工具链用法详解

来自:网络
时间:2022-08-06
阅读:

Go官方工具链

为了从任意目录运行Go官方工具链中工具命令(通过go命令), Go官方工具链安装目录下的bin子目录路径必须配置在PATH环境变量中。 当使用安装程序安装Go官方工具链时,安装程序很可能已经自动地将此配置好了。windows环境中需要在把安装目录下bin子目录添加到高级系统环境变量中保存生效。
Go官方工具链近来的版本都支持一个称为Go模块(Go modules)的特性, 用来管理项目依赖。此特性在版本1.11中被试验性引入, 在版本1.16中被默认支持。

第一个环境变量

我们应该了解一个环境变量:GOPATH。 此环境变量的默认值为当前用户的HOME目录下的名为go文件夹对应的目录路径。 GOPATH环境变量可以被手动地配置多个路径。 以后,当GOPATH文件夹被提及的时候,它表示GOPATH环境变量中的第一个路径对应的文件夹。

  • GOPATH文件夹中的pkg子文件夹用来缓存被本地项目所依赖的Go模块(一个Go模块为若干Go库包的集合)的版本。
  • GOBIN环境变量用来指定go install子命令产生的Go应用程序二进制可执行文件应该存储在何处。 它的默认值为GOPATH文件夹中的bin子目录所对应的目录路径。
  • GOBIN路径需配置在PATH环境变量中,以便从任意目录运行这些Go应用程序。

运行一个程序

Go官方工具链工具要求所有的Go源代码文件必须以.go后缀结尾。这里,我们假设一个最简单的Go程序放在hello.go的文件中。下面是最简单的Go程序。

package main

import "fmt"

func main() {
    fmt.Println("hello")
}

打开一个终端(控制台)并进入上述源文件所在的目录,然后运行
$ go run hello.go
如果代码中有语法错误,这些错误将输出在终端中。

如果一个程序的main包中有若干Go源代码文件,我们可以使用下面的命令运行此程序。
$ go run .
注意:

  • go run子命令并不推荐在正式的大项目中使用。go run子命令只是一种方便的方式来运行简单的Go程序。 对于正式的项目,最好使用go build或者go install子命令构建可执行程序文件来运行Go程序。
  • 支持Go模块特性的Go项目的根目录下需要一个go.mod文件。此文件可以使用go mod init子命令来生成(见下)。

更多go子命令

上面提到的三个go子命令(go rungo buildgo install) 将只会输出代码语法错误。它们不会输出可能的代码逻辑错误(即警告)。 go vet子命令可以用来检查可能的代码逻辑错误(即警告)。

我们可以使用go fmt子命令来用同一种代码风格格式化Go代码。

我们可以使用go test子命令来运行单元和基准测试用例。

我们可以使用go doc子命令在终端中查看Go代码库包的文档。

强烈推荐让你的Go项目支持Go模块特性来简化依赖管理。对一个支持Go模块特性的项目:

  • go mod init example.com/myproject命令可以用来在当前目录中生成一个go.mod文件。 当前目录将被视为一个名为example.com/myproject的模块(即当前项目)的根目录。 此go.mod文件将被用来记录当前项目需要的依赖模块和版本信息。 我们可以手动编辑或者使用go子命令来修改此文件。
  • go mod tidy命令用来通过扫描当前项目中的所有代码来添加未被记录的依赖至go.mod文件或从go.mod文件中删除不再被使用的依赖。
  • go get命令用拉添加、升级、降级或者删除单个依赖。此命令不如go mod tidy命令常用。
  • 从Go官方工具链1.16版本开始,我们可以运行go install example.com/program@latest来安装一个第三方Go程序的最新版本(至GOBIIN目录)。 在Go官方工具链1.16版本之前,对应的命令是go get -u example.com/program(现在已经被废弃而不再推荐被使用了)。

我们可以运行go help aSubCommand来查看一个子命令aSubCommand的帮助信息。
运行不带参数的go命令将会列出所有支持的go子命令。

返回顶部
顶部