17370845950

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 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 会报错。