第一个 Go 程序

这一节写一个最小程序。

一、创建目录

mkdir hello-go
cd hello-go

初始化模块:

go mod init example.com/hello-go

生成:

go.mod

内容类似:

module example.com/hello-go

go 1.26

go 后面的版本会根据你的 Go 工具链生成,不需要手写成和教程完全一样。

二、创建 main.go

package main

import "fmt"

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

目录结构:

hello-go/
├── go.mod
└── main.go

三、运行程序

go run .

输出:

Hello, Go

go run . 的意思是:运行当前目录这个模块里的主程序。

四、编译程序

go build

Windows 会生成:

hello-go.exe

macOS / Linux 会生成:

hello-go

然后可以直接运行这个可执行文件。

五、常见错误

1. 找不到 go 命令

go: command not found

说明 Go 没安装好,或者环境变量没有生效。重新打开终端再试。

2. 没有 go.mod

go: cannot find main module

说明当前目录不是 Go Modules 项目。执行:

go mod init example.com/hello-go

六、main 包和 main 函数

能运行的 Go 程序必须满足两个条件:

package main

并且有:

func main() {
}

普通工具包不需要 main 包和 main 函数。