go run适用于快速验证逻辑,需package main和func main(),单文件直接go run main.go,多文件须显式列出全部;不生成二进制,每次重新编译,临时执行后清理,不适合部署。

go run 是最直接的执行方式,但不是所有场景都适用——关键看你要调试、部署,还是快速验证逻辑。
用 go run 快速验证代码
适合单文件脚本、教学示例或临时测试,不生成二进制文件,每次运行都重新编译。
- 必须是
package main且含func main() - 文件名任意,比如
hello.go或calc.go,但不能是lib.go(非 main 包) - 命令里要写全路径:如果当前目录下有
main.go,就运行go run main.go;如果有多个.go文件(如main.go+utils.go),得一起列出来:go run main.go utils.go - 常见报错
no Go files in current directory:说明没找到.go文件,或当前不在源码目录
用 go build 生成可执行文件
适合交付、部署或需要反复运行的程序。生成的二进制文件不含依赖,可直接拷走运行(注意平台兼容性)。
-
go build main.go→ 生成同名可执行文件(如 Linux/macOS 下是main,Windows 下是main.exe) -
go build -o myapp main.go→ 指定输出文件名 - 若项目含多个包(比如
cmd/下有main.go),需进入该目录再 build,或用go build ./cmd/myapp - 生成的二进制默认静态链接,但若用了
cgo(如调用 C 库),则可能动态依赖系统 libc,跨机器运行前要验证
用 go mod init 管理多文件项目
当代码超过一个文件、开始引入第三方库(比如 github.com/spf13/cobra),就必须初始化模块——否则 go run 和 go build 可能找不到依赖或报 unknown revision。
- 在项目根目录运行
go mod init example.com/myapp(模块名可以是假域名,只要唯一) - 之后加 import 就会自动记录到
go.mod;运行go run main.go时,Go 会按需下载并缓存依赖 - 别手动编辑
go.sum:它是校验和快照,被篡改会导致go build拒绝构建 - 如果遇到
cannot find module providing package xxx,先确认 import 路径拼写是否正确(大小写敏感),再检查对应模块是否已go get或出现在go.mod中
go run,或把 go.mod 放在了子目录却从外层调用命令。动手前,先 pwd 看清位置,再 ls go.mod main.go 确认关键文件存在。golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











