Go / 系统课时
运行并构建第一个程序
运行并构建第一个程序
Go 的可执行程序必须由 package main 提供入口函数 func main()。本篇从一个只有几行的程序出发,分别用 go run . 临时编译并执行,再用 go build 生成可重复运行的本地二进制,并用实际输出确认编译执行链路。
学习目标
- 写出包含
package main和func main()的最小可执行程序。 - 区分
go run .与go build的产物和使用场景。 - 通过程序输出验证源码、编译和二进制执行都正常。
准备最小 main 包
在一个空目录中先初始化模块,这样 go run . 和 go build . 都能以当前模块为边界解析包。
mkdir firstapp
cd firstapp
go mod init example.com/firstapp预期输出
go: creating new go.mod: module example.com/firstapp将下面内容保存为 main.go:
package main
import "fmt"
func main() {
// main 是可执行 main 包的入口;返回后进程结束。
fmt.Println("hello, Go 1.27")
}预期结果
当前目录至少包含 go.mod 和 main.go;此时程序尚未执行。package main 表示这个包要链接成可执行程序;其中必须声明不接收参数、也不返回值的 func main()。fmt 来自标准库,因此这个例子不需要下载第三方依赖。
用 go run 临时编译并执行
在包含 go.mod 和 main.go 的目录运行:
go run .预期输出
hello, Go 1.27go run . 会先编译当前 main 包及其依赖,再立即执行临时生成的程序;它适合开发时快速验证。执行结束后,当前目录不会因为这条命令多出一个供你长期保留的应用二进制。
如果修改 main.go 后再次执行 go run .,Go 会按新源码重新完成所需的构建步骤,因此它适合“改代码—运行—观察输出”的短循环。
用 go build 生成本地二进制
需要得到可直接运行的文件时,显式指定输出名。Linux 和 macOS 可执行:
go build -o firstapp .
./firstapp预期输出
hello, Go 1.27Windows PowerShell 对应使用 go build -o firstapp.exe .,随后运行 .\firstapp.exe,程序输出同样是 hello, Go 1.27。go build 成功后,二进制会保留在你指定的位置;后续直接运行它时不需要再次调用 go run。
-o firstapp 只决定输出文件名,不会改变包名或 module path。团队脚本通常显式指定 -o,这样构建产物名称不会依赖当前目录名。
判断失败发生在哪一层
最小程序出问题时,可以按“模块位置—包类型—入口函数—编译错误”的顺序检查。先确认当前目录属于预期模块:
go env GOMOD
go list
go build -o firstapp .预期结果
第一行应指向当前项目的 go.mod;第二行应列出 example.com/firstapp;第三条命令成功时通常不输出文本,并生成 firstapp(Windows 可指定 firstapp.exe)。如果源码写成 package demo,它就不再是可执行 main 包;如果保留 package main 却删掉 func main(),链接阶段也无法得到可运行入口。若编译器报告具体文件和行号,先修复最前面的语法或类型错误,再重新执行 go build,最后直接运行生成的二进制确认输出仍为 hello, Go 1.27。