构建一个 cli 工具的关键在于结构设计、参数处理、跨平台编译与用户体验优化。1. 项目结构应清晰划分 main.go 为入口，子命令放 cmd/ 目录，公共逻辑放 pkg 或根目录；2. 使用 flag 包处理基础参数，复杂场景可用 cobra 实现子命令；3. 利用 go 的交叉编译能力生成多平台二进制文件，通过设置 goos 和 goarch 编译 windows、linux、mac 版本；4. 提供帮助文档和友好错误提示，自定义 flag.usage 或使用 cobra 自动生成帮助信息，并统一错误处理以提升用户体验。
用 Golang 构建一个 CLI 工具其实并不难，尤其是标准库中提供了 flag 和 os 等包，能让你快速搭建起功能完整的命令行程序。这篇文章会从结构设计、参数处理到构建发布几个关键点入手，告诉你怎么一步步做出一个像样的 CLI 工具。
1. 设计项目结构：别一开始就乱了手脚
刚开始写 CLI 工具时，很多人喜欢一股脑把代码全塞进 main.go。但随着功能变多，维护起来就变得很痛苦。
建议一开始就把结构理清楚：
立即学习“go语言免费学习笔记（深入）”；
-
main.go只负责调用入口 - 每个子命令或功能模块单独放一个文件或目录（比如
cmd/） - 公共逻辑抽成
pkg/或者直接放在根目录下
举个例子：
mycli/
├── main.go
├── cmd/
│ ├── root.go
│ └── version.go
└── utils/
└── logger.go这样后期扩展也方便，比如你后面想加一个 mycli config set 这种嵌套命令的时候，结构清晰就能省不少事。
2. 使用 flag 处理命令行参数：基础但够用
Golang 标准库的 flag 包已经能满足大多数 CLI 工具的需求。你可以轻松定义字符串、布尔值、整数等类型的参数。
比如你想做一个带 -v 参数显示版本号的功能：
version := flag.Bool("v", false, "显示版本信息")
flag.Parse()
if *version {
fmt.Println("Version: v0.1.0")
}如果你需要更复杂的命令结构，比如支持子命令（如 git commit, git push），可以考虑使用 spf13/cobra，它是一个非常流行的 CLI 框架，适合大型项目。
3. 编译和打包：别忘了跨平台支持
写完代码之后，下一步就是编译成可执行文件。Go 的一大优势就是能很容易地交叉编译出不同平台下的二进制文件。
基本命令是：
go build -o mycli main.go
如果你想为 Windows/Linux/Mac 都打包一份，可以这样操作：
-
Windows:
GOOS=windows GOARCH=amd64 go build -o mycli.exe
-
Linux:
GOOS=linux GOARCH=amd64 go build -o mycli
-
Mac:
GOOS=darwin GOARCH=amd64 go build -o mycli
还可以写个简单的 shell 脚本自动打包所有平台，或者用一些工具帮你做 CI 自动化构建。
4. 添加帮助文档和错误提示：用户体验不能忽略
一个好用的 CLI 工具必须有清晰的帮助说明。可以通过 -h 或者 --help 来触发，也可以在用户输入错误命令时给出友好提示。
flag 包自带了默认的帮助输出，你也可以自定义：
flag.Usage = func() {
fmt.Fprintf(os.Stderr, "Usage of %s:\n", os.Args[0])
flag.PrintDefaults()
}如果是用了 Cobra，那它的帮助系统已经封装得很好，只需写好描述即可自动输出漂亮的帮助信息。
另外，遇到错误时不要只是 panic，最好统一返回错误信息，并以非 0 状态码退出程序，方便脚本调用判断。
基本上就这些。CLI 工具开发看起来简单，但要做得好用、稳定、易维护，还是得注意结构设计和细节处理。不复杂，但容易忽略的地方还挺多。
