Go / 系统课时

运行并构建第一个程序

运行并构建第一个程序

Go 的可执行程序必须由 package main 提供入口函数 func main()。本篇从一个只有几行的程序出发,分别用 go run . 临时编译并执行,再用 go build 生成可重复运行的本地二进制,并用实际输出确认编译执行链路。

学习目标

  • 写出包含 package main 和 func main() 的最小可执行程序。
  • 区分 go run . 与 go build 的产物和使用场景。
  • 通过程序输出验证源码、编译和二进制执行都正常。

准备最小 main 包

在一个空目录中先初始化模块,这样 go run . 和 go build . 都能以当前模块为边界解析包。

bash
mkdir firstapp
cd firstapp
go mod init example.com/firstapp

预期输出

text
go: creating new go.mod: module example.com/firstapp

将下面内容保存为 main.go:

go
package main

import "fmt"

func main() {
	// main 是可执行 main 包的入口;返回后进程结束。
	fmt.Println("hello, Go 1.27")
}

预期结果

text
当前目录至少包含 go.mod 和 main.go;此时程序尚未执行。

package main 表示这个包要链接成可执行程序;其中必须声明不接收参数、也不返回值的 func main()。fmt 来自标准库,因此这个例子不需要下载第三方依赖。

用 go run 临时编译并执行

在包含 go.mod 和 main.go 的目录运行:

bash
go run .

预期输出

text
hello, Go 1.27

go run . 会先编译当前 main 包及其依赖,再立即执行临时生成的程序;它适合开发时快速验证。执行结束后,当前目录不会因为这条命令多出一个供你长期保留的应用二进制。

如果修改 main.go 后再次执行 go run .,Go 会按新源码重新完成所需的构建步骤,因此它适合“改代码—运行—观察输出”的短循环。

用 go build 生成本地二进制

需要得到可直接运行的文件时,显式指定输出名。Linux 和 macOS 可执行:

bash
go build -o firstapp .
./firstapp

预期输出

text
hello, Go 1.27

Windows PowerShell 对应使用 go build -o firstapp.exe .,随后运行 .\firstapp.exe,程序输出同样是 hello, Go 1.27。go build 成功后,二进制会保留在你指定的位置;后续直接运行它时不需要再次调用 go run。

-o firstapp 只决定输出文件名,不会改变包名或 module path。团队脚本通常显式指定 -o,这样构建产物名称不会依赖当前目录名。

判断失败发生在哪一层

最小程序出问题时,可以按“模块位置—包类型—入口函数—编译错误”的顺序检查。先确认当前目录属于预期模块:

bash
go env GOMOD
go list
go build -o firstapp .

预期结果

text
第一行应指向当前项目的 go.mod;第二行应列出 example.com/firstapp;第三条命令成功时通常不输出文本,并生成 firstapp(Windows 可指定 firstapp.exe)。

如果源码写成 package demo,它就不再是可执行 main 包;如果保留 package main 却删掉 func main(),链接阶段也无法得到可运行入口。若编译器报告具体文件和行号,先修复最前面的语法或类型错误,再重新执行 go build,最后直接运行生成的二进制确认输出仍为 hello, Go 1.27。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

运行并构建第一个程序

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通