Go 零基础教程

Go 命令行工具

Go 语言提供了一套极其强大的命令行工具（CLI），它们能极大地简化我们的开发工作流。

本章将带你深入探索三个最核心的工具：go fmt、go run 和 go build。

我们将全面讲解它们的功能、使用方法以及带来的巨大优势。掌握它们，你就能写出更整洁、更高效、更易于维护的 Go 代码。

1. go fmt：代码自动格式化神器

go fmt 是一个能根据 Go 官方代码风格指南，自动格式化你的源代码的工具。这套指南确保了全世界所有的 Go 项目在视觉上保持高度一致。使用 go fmt 可以让你的代码强制符合这些标准，不仅方便别人阅读，也方便未来的你自己进行维护。

1.1 为什么要使用 go fmt？

  • 绝对的一致性： 在你的整个项目乃至整个 Go 生态系统中，强制推行统一的编码风格。
  • 极高的可读性： 让代码更易于阅读和理解，降低大脑的认知负荷。
  • 节省代码审查 (Code Review) 时间： 彻底终结团队里关于“大括号该放哪”、“缩进用空格还是 Tab”的无聊争论，让代码审查员将精力集中在核心业务逻辑上。
  • 完全自动化： 自动完成格式化过程，省时省力。
  • 官方标准： 严格遵守官方规范，确保最佳实践。

1.2 如何使用 go fmt

使用 go fmt 的基础语法非常简单：

go fmt <文件_或_目录>
  • <文件_或_目录>: 指定你要格式化的目标。如果你传入的是一个目录，go fmt 会递归地格式化该目录下所有的 .go 文件。

例如，如果你只想格式化一个名为 main.go 的文件：

go fmt main.go

如果你想格式化当前目录下的所有 Go 文件（最常用的命令）：

go fmt .
注意：go fmt 会直接修改并覆盖原文件。

1.3 格式化效果对比

假设你有一个格式写得很随意的 Go 代码文件 example.go：

package main
import "fmt"
func main () {
fmt.Println("Hello, World!")
}

在终端运行 go fmt example.go 后，代码会被瞬间整理成这样：

package main

import "fmt"

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

注意观察它做了哪些改变：

  • 在操作符和关键字周围添加了合理的空格。
  • 统一了代码的缩进（Go 默认使用 Tab 缩进）。
  • 修正了 main 函数括号的位置。

1.4 goimports：更强大的进阶工具

虽然 go fmt 专注于代码格式，但还有一个叫 goimports 的超级工具。它是 go fmt 的超集：不仅包含所有的格式化功能，还能自动管理你的 import 导入语句。它会自动帮你添加漏掉的包，并且删除代码里没用到的包，这能极大提升你的开发体验。

要安装 goimports，请在终端运行以下命令：

go install golang.org/x/tools/cmd/goimports@latest

它的用法和 go fmt 几乎一样：

goimports -w <文件_或_目录>
  • -w 标志（write）告诉 goimports 将修改后的结果写回到源文件中。

2. go run：即时编译与运行

go run 是一个非常便捷的工具，用于快速编译并执行 Go 程序。它在后台默默地将你的源码编译成一个临时文件，然后立刻运行它。这在日常开发测试和做实验时超级好用。

2.1 如何使用 go run

基础语法如下：

go run <文件.go> [参数...]
  • <文件.go>: 指定你要编译并运行的主 Go 源码文件。
  • [参数...]: （可选）传递给程序的命令行参数。

运行单个文件：

go run main.go

如果你想在运行时给程序传递参数，可以直接加在文件名后面：

go run main.go 参数1 参数2 参数3

这些参数可以在你的 Go 代码中通过 os.Args 切片 (Slice) 来获取。

2.2 读取命令行参数示例

来看看这个 main.go 文件：

package main

import (
	"fmt"
	"os"
)

func main() {
	// os.Args[0] 是程序本身的名字，所以我们从索引 1 开始截取真实参数
	fmt.Println("接收到的参数:", os.Args[1:])
}

如果在终端运行 go run main.go hello world，你将看到以下输出：

接收到的参数: [hello world]

2.3 运行多个文件

当你的程序被拆分到同一个包下的多个文件时，go run 可以同时编译并运行它们：

go run file1.go file2.go file3.go

文件的排列顺序通常无所谓，Go 编译器会聪明地自动解析依赖关系。但你必须确保把属于 main 包的所有相关文件都包含进去。

3. go build：编译独立可执行文件

与 go run 不同，go build 会将你的 Go 源码真正编译成一个独立的可执行二进制文件 (Executable binary)。它编译完后不会立刻运行程序。生成的可执行文件可以脱离 Go 开发环境，直接发给别人并在他们的机器上独立运行。

3.1 如何使用 go build

基础语法如下：

go build [标志] [包名]
  • [标志]: （可选）用来修改编译行为的参数（比如用 -o 来指定输出的文件名）。
  • [包名]: 指定要编译的包。如果不写，go build 默认编译当前目录下的包。

在当前目录直接编译：

go build

这会在当前目录下生成一个与目录同名（或与包名同名）的可执行文件。

如果你想自定义生成的文件名，可以使用 -o (output) 标志：

go build -o myprogram

这会生成一个名为 myprogram 的可执行文件。

3.2 交叉编译 (Cross-Compilation) 杀手锏

go build 原生支持交叉编译！这意味着你可以在 Mac 上编译出 Windows 能跑的 .exe 程序，或者在 Windows 上编译出 Linux 服务器能跑的程序。这是 Go 语言极其强大的一项特性，让你能轻松将程序分发给使用不同操作系统的用户。

想要交叉编译，你只需要在运行 go build 之前，临时设置两个环境变量：GOOS (目标操作系统) 和 GOARCH (目标 CPU 架构)。

例如，在 Mac/Linux 终端下，为 Windows (64位) 编译程序：

GOOS=windows GOARCH=amd64 go build -o myprogram.exe

为 Linux (32位) 编译程序：

GOOS=linux GOARCH=386 go build -o myprogram

3.3 编译与运行示例

假设你的 main.go 内容如下：

package main

import "fmt"

func main() {
	fmt.Println("这是一个被编译后的独立程序。")
}

在终端运行 go build 后，当前目录会多出一个可执行文件（Mac/Linux 下通常叫 main，Windows 下叫 main.exe）。

你可以直接在终端运行这个生成的文件，不需要再加 go 命令：

./main      # Linux / macOS 下的运行方式
main.exe    # Windows 下的运行方式