Go命令行工具需用package main和func main()作为入口,用go run调试、go build生成跨平台二进制,flag包可满足基础参数解析需求。

在 Go 中开发命令行工具非常轻量,不需要额外框架也能快速构建可执行程序。关键在于理解 go build 和 go run 的行为差异、如何组织入口文件、以及怎样让二进制支持跨平台和参数解析。
确保 main 包和 main 函数正确存在
Go 命令行工具必须有一个 main 包,且其中定义 func main()。这是程序的唯一入口:
- 文件必须放在
package main中(不能是package cmd或其他) - 至少一个
.go文件里要有func main() { ... } - 如果项目含多个
.go文件,它们都需在同一个目录下,且都属于main包
用 go run 快速测试,但注意它不生成二进制
go run 编译并立即运行,适合开发调试,但它每次都会重新编译,且不会留下可执行文件:
-
go run main.go—— 运行单个文件 -
go run .—— 运行当前目录下所有main包文件(推荐方式) -
go run ./cmd/mytool—— 若命令放在子目录中(如cmd/mytool/main.go),可直接指定路径
注意:go run 不会检查未被引用的 .go 文件,也不会自动构建依赖的内部包 —— 它只处理显式传入的路径或当前目录下的 main 包文件。
立即学习“go语言免费学习笔记(深入)”;
用 go build 生成独立可执行文件
go build 把源码编译成静态链接的二进制,无需 Go 环境即可运行(默认不含 CGO):
-
go build -o mytool main.go—— 输出为mytool(Linux/macOS)或mytool.exe(Windows) -
go build -o bin/mytool .—— 构建当前目录,并输出到bin/目录 -
GOOS=windows GOARCH=amd64 go build -o mytool.exe .—— 交叉编译 Windows 版本(macOS/Linux 上也可执行)
生成的二进制自带全部依赖,体积略大但部署极简 —— 这是发布 CLI 工具的标准做法。
添加命令行参数支持(推荐 flag 标准库)
Go 自带 flag 包,足够应对大多数场景。在 main() 中初始化即可:
- 定义变量:
var verbose = flag.Bool("v", false, "enable verbose mode") - 解析参数:
flag.Parse()(必须在使用前调用) - 读取值:
if *verbose { ... }(注意解引用) - 支持
-v、--help、-f file.txt等常见格式
如需更高级功能(子命令、自动 help 文档、bash 补全),可后续引入 spf13/cobra,但起步阶段 flag 完全够用。
不复杂但容易忽略:确保 GOBIN 或 $PATH 配置正确,才能全局调用自己构建的工具;另外,避免在 main 包中 import 未使用的包,否则 go build 会报错。










