前言

Go语言是一种开源的编程语言，由Google开发并于2009年首次发布。它以其简洁、高效和并发性能而备受开发者的喜爱。作为一门相对年轻的语言，Go语言的学习和使用对于初学者来说可能会有一些挑战。因此，本文将介绍一些常用的Go语言命令，帮助读者更好地理解和使用这门语言。

常用命令

以下是一些常用的Go命令，这些命令可以帮助您在Go开发中进行编译、测试、运行和管理依赖项等任务。

命令	描述
go build	编译Go程序包及其依赖项。
go test	运行包的测试。
go run	编译并运行Go程序。
go clean	删除编译生成的对象文件和缓存文件。
go bug	启动一个用于报告bug的工具。
go doc	显示有关包或符号的文档。
go env	打印有关Go环境的信息。
go fix	更新包以使用新的API。
go fmt	使用gofmt重新格式化Go包的源代码。
go generate	通过处理源代码来生成Go文件。
go get	将依赖项添加到当前模块并安装它们。
go install	编译并安装包及其依赖项。
go list	列出包或模块的信息。
go mod	用于模块维护,包括初始化模块、添加和更新依赖项等。
go work	用于工作区维护,例如查看、清理或打印工作区信息。
go tool	运行指定的Go工具。
go version	打印Go的版本信息。
go vet	检查 Go 源码并报告可疑的错误。

---

go build

go build命令是用于编译Go语言程序并生成可执行文件。

它可以将Go源代码编译成机器代码，并将其打包成可执行文件，方便在不同的操作系统上运行。

使用go build命令非常简单，只需在终端中输入以下命令：

go build [文件名]

其中，[文件名]是要编译的Go源文件的文件名（不包括扩展名.go）。如果不指定文件名，则默认编译当前目录下的所有Go源文件。

示例

下面是一个示例，假设我们有一个名为hello.go的Go源文件，内容如下：

package main

import "fmt"

func main() {
	fmt.Println("Hello, Go!")
}

我们可以使用go build命令来编译该文件：

go build hello.go

执行该命令后，会在当前目录下生成一个名为hello的可执行文件。我们可以直接运行该文件来执行Go程序：

./hello

运行结果将会输出：

Hello, Go!

除了编译单个文件外，go build命令还支持编译整个项目。只需在项目根目录下执行go build命令即可。这将会编译整个项目，并在根目录下生成一个可执行文件。

需要注意的是，go build命令只会编译Go源代码，不会执行任何测试。如果需要执行测试，可以使用go test命令。

参数说明

参数	说明
-o	指定生成的可执行文件的名称和路径。例如，使用go build -o myapp命令可以将生成的可执行文件命名为myapp。
-v	显示编译过程中的详细信息。使用该参数可以查看编译过程中的详细输出。
-x	显示执行的编译操作。使用该参数可以查看编译操作的详细信息，并同时执行编译操作。
-ldflags	指定链接标志。该参数可以用于传递链接器的标志，例如设置可执行文件的版本信息等。
-a	强制重新编译所有的包。使用该参数可以强制重新编译所有的包，而不仅仅是修改过的包。
-race	指定编译时使用的标签。该参数可以用于根据标签选择性地编译代码，例如根据操作系统或架构选择性地编译代码。
-mod	指定使用的模块模式。该参数可以用于指定使用的模块模式，例如使用mod或vendor模式。

需要注意的是，go build命令的参数可以组合使用，以满足不同的编译需求。例如，可以使用go build -o myapp -ldflags "-X main.version=1.0"命令来指定生成的可执行文件的名称和版本信息。

通过组合使用这些参数，我们可以更灵活地进行编译操作，以满足不同的需求。

go test

go test命令用于运行测试代码并生成测试报告。

它可以自动识别项目中的测试文件，并执行其中的测试函数，然后输出测试结果。

使用go test命令非常简单，只需在终端中输入以下命令：

go test

该命令会自动在当前目录下寻找以_test.go结尾的文件，并执行其中的测试函数。测试函数的命名必须以Test开头，并接着是要测试的函数名，例如TestAdd()。

示例

下面是一个示例，假设我们有一个名为math.go的文件，其中定义了一个加法函数Add()，以及一个名为math_test.go的测试文件，内容如下：

​ math.go：

package math

func Add(a, b int) int {
return a + b
}

​ math_test.go：

package math
import "testing"

func TestAdd(t *testing.T) {
    result := Add(2, 3)
    if result != 5 {
    	t.Errorf("Add(2, 3) = %d; want 5", result)
    }
}

我们可以使用go test命令来运行该测试文件：

go test

执行该命令后，会输出测试结果：

PASS
ok _/path/to/project 0.001s

这表示测试通过，没有发现错误。如果测试中存在错误，将会输出相应的错误信息。

除了默认的输出结果外，go test命令还支持一些可选的参数，例如-v参数可以输出更详细的测试结果，-cover参数可以生成代码覆盖率报告等。

参数说明

参数	说明
-v	显示详细的测试信息。使用该参数可以查看每个测试用例的详细输出。
-run	指定要运行的测试用例的正则表达式。使用该参数可以选择性地运行符合指定正则表达式的测试用例。
-cover	生成代码覆盖率报告。使用该参数可以生成代码覆盖率报告，显示测试代码对被测试代码的覆盖情况。
-coverprofile	指定生成的代码覆盖率文件的名称和路径。使用该参数可以将生成的代码覆盖率报告保存到指定的文件中。
-covermode	指定代码覆盖率的模式。该参数可以用于指定代码覆盖率的计算方式。
-bench	运行性能测试。使用该参数可以运行性能测试，并输出性能测试的结果。
-benchmem	显示内存分配的统计信息。使用该参数可以显示性能测试过程中的内存分配情况。
-benchtime	指定性能测试的运行时间。该参数可以用于指定性能测试的运行时间，例如设置为"10s"表示运行10秒。
-timeout	指定测试的超时时间。该参数可以用于指定测试的超时时间，例如设置为"5s"表示测试超过5秒将被终止。
-short	运行短时间的测试。使用该参数可以运行短时间的测试，例如跳过一些耗时较长的测试用例。

go test命令的参数可以组合使用，以满足不同的测试需求。例如，可以使用go test -v -cover命令来运行测试并生成代码覆盖率报告。

go run

go run命令是用于直接运行Go源代码文件。

它可以在不生成可执行文件的情况下，直接编译并运行Go程序。

使用go run命令非常简单，只需在终端中输入以下命令：

go run <文件名>.go

其中，<文件名>.go是要运行的Go源代码文件的文件名。

示例

下面是一个示例，假设我们有一个名为hello.go的文件，内容如下：

package main

import "fmt"

func main() {
	fmt.Println("Hello, Go!")
}

我们可以使用go run命令来运行该文件：

go run hello.go

执行该命令后，会输出程序的运行结果：

Hello, Go!

可以看到，go run命令会自动编译并运行指定的Go源代码文件，并将结果输出到终端。

需要注意的是，go run命令只能用于运行单个Go源代码文件，不能用于运行多个文件或整个项目。

如果需要运行多个文件或整个项目，可以考虑使用go build命令生成可执行文件，然后再运行可执行文件。

参数说明

参数	说明
-a	强制重新编译所有依赖的包。使用该参数可以确保所有依赖的包都被重新编译，而不使用缓存的结果。
-n	打印编译过程中的命令，但不执行。使用该参数可以查看编译过程中执行的命令，但不实际执行这些命令。
-x	打印编译过程中的详细信息。使用该参数可以查看编译过程中的详细信息，包括编译器和链接器的命令。
-work	打印编译过程中的临时工作目录。使用该参数可以查看编译过程中生成的临时文件和目录。
-vet	运行静态代码分析工具vet。使用该参数可以在编译过程中运行vet工具，检查代码中的潜在问题。
-race	启用数据竞争检测。使用该参数可以帮助发现并解决并发访问共享数据的问题。
-mod	指定使用的模块支持方式。该参数可以用于指定使用的模块支持方式
-tags	指定编译时使用的标签。例如设置为"debug"表示只编译带有debug标签的代码。

go run命令的参数可以组合使用，以满足不同的编译和运行需求。例如，可以使用go run -race命令来编译并运行带有数据竞争检测的代码。

go clean

go clean命令是Go语言中常用的命令之一，用于清理项目目录下生成的可执行文件、测试结果和临时文件等。

使用go clean命令非常简单，只需在终端中输入以下命令：

go clean

该命令会删除项目目录下生成的可执行文件、测试结果和临时文件等。它会根据项目的构建配置和操作系统的不同，删除不同的文件。

示例

- 清理可执行文件：

go clean -i -r

该命令会删除项目目录下生成的可执行文件。-i参数表示同时删除与可执行文件相关的安装目录，-r参数表示递归删除。

- 清理测试结果：

go clean -testcache

该命令会删除项目目录下生成的测试结果缓存文件。

- 清理临时文件：

go clean -cache

该命令会删除项目目录下生成的临时文件和缓存文件。

需要注意的是，go clean命令会删除项目目录下生成的文件，因此在使用该命令之前，建议先备份重要的文件。

参数介绍

参数名	说明
-i	同时删除与可执行文件相关的安装目录。
-r	递归删除。该参数会删除指定目录及其子目录下的文件。
-n	显示将要执行的清理操作，但不实际执行。使用该参数可以查看清理操作的详细信息，而不会真正删除文件。
-cache	清理临时文件和缓存文件。该参数会删除项目目录下生成的临时文件和缓存文件。
-testcache	清理测试结果缓存文件。该参数会删除项目目录下生成的测试结果缓存文件。
-modcache	清理模块缓存文件。该参数会删除项目目录下生成的模块缓存文件。
-x	显示执行的清理操作。使用该参数可以查看清理操作的详细信息，并同时执行清理操作。

go clean命令的参数可以用于指定清理的范围和方式。通过组合使用这些参数，我们可以更灵活地进行清理操作，以满足不同的需求。

---

总结

本文对 go命令的buid,test,run,clean四个命令的介绍，示例，以及参数说明，下一章会介绍剩余的几种命令

---

写在最后

感谢您的支持和鼓励！ 😊🙏

如果大家对相关文章感兴趣，可以关注公众号"架构殿堂"，会持续更新AIGC，java基础面试题, netty, spring boot, spring cloud等系列文章，一系列干货随时送达!