用golang实现cli工具可借助cobra库快速完成。1. 安装cobra：使用go install github.com/spf13/cobra-cli@latest；2. 初始化项目结构：运行cobra init --pkg-name mycli生成基础代码；3. 添加子命令：执行cobra add greet并修改run函数实现参数处理；4. 自定义flag：通过flags().boolp添加--shout选项并在run中判断其值；5. 运行测试命令验证功能；6. 使用go build编译后放入系统路径即可全局调用。cobra还支持自动补全、配置文件读取和错误处理等功能，有助于提升开发效率与用户体验。
用 Golang 实现一个 CLI 工具其实并不难，尤其是借助了 cobra 这个强大的库之后。cobra 是目前 Go 社区中最流行的命令行应用开发框架之一，它不仅支持多级子命令、自动帮助生成、配置文件读取等特性，还非常容易上手。
如果你是刚接触 CLI 开发的 Go 初学者，cobra 会是一个很好的起点。下面我们就一步步来看看如何用它创建你的第一个命令行工具。
安装 cobra
在开始之前，你需要先安装 cobra。最简单的方式是使用 go install 命令：
立即学习“go语言免费学习笔记（深入）”；
go install github.com/spf13/cobra-cli@latest
这样你就可以通过命令行工具快速生成项目结构。如果你想手动导入包也可以，但推荐新手从 cli 工具入手，能更快看到效果。
安装完成后，输入：
cobra --help
如果能看到帮助信息，说明安装成功。
创建你的第一个 CLI 项目
接下来，我们来创建一个简单的 CLI 应用。假设我们要做一个叫做 mycli 的命令行工具，它有一个子命令 greet，可以向用户打招呼。
初始化项目结构
进入你想存放项目的目录，运行初始化命令：
cobra init --pkg-name mycli
这会在当前目录下生成基本的项目结构，包括 main.go 和 cmd/root.go 文件。这些代码已经足够运行一个基础的 CLI 程序了。
你可以直接运行：
go run main.go
输出会是类似这样的内容：
A longer description that spans multiple lines and likely uses
some formatting.
Usage:
mycli [flags]
mycli [command]
Available Commands:
help Help about any command
Flags:
--config string config file (default is $HOME/.mycli.yaml)
-h, --help help for mycli
-t, --toggle Help message for toggle
Use "mycli [command] --help" for more information about a command.说明 root 命令已经就绪了。
添加子命令（比如 greet）
现在我们来添加一个子命令 greet，让它可以接收用户名并打印问候语。
运行以下命令生成子命令模板：
cobra add greet
这会在 cmd/ 目录下生成一个 greet.go 文件。打开这个文件，找到 Run 函数部分，修改成如下内容：
func runGreet(cmd *cobra.Command, args []string) {
name := "World"
if len(args) > 0 {
name = args[0]
}
fmt.Printf("Hello, %s!\n", name)
}然后保存文件。现在运行：
go run main.go greet Alice
你应该会看到输出：
Hello, Alice!
这样你就完成了一个带参数处理的子命令了。
自定义 flag 和参数处理
除了接收位置参数（positional arguments），你还可以给命令添加 flag。例如我们可以让 greet 支持一个 --shout 的 flag，表示是否要大写输出。
在 greet.go 中的 init() 函数里添加：
greetCmd.Flags().BoolP("shout", "s", false, "Shout the greeting in uppercase")然后在 runGreet 函数中判断 flag：
shout, _ := cmd.Flags().GetBool("shout")
message := fmt.Sprintf("Hello, %s!", name)
if shout {
message = strings.ToUpper(message)
}
fmt.Println(message)运行测试：
go run main.go greet Alice --shout
输出应为：
Hello, Alice!
这就是 flag 的基本用法。你可以根据需要添加各种类型的 flag，比如字符串、整数、布尔值等。
一些实用小技巧
-
自动补全：cobra 支持 shell 补全功能，只需执行
source <(mycli completion bash)或其他 shell 类型即可。 -
配置文件：默认情况下，cobra 会查找
.mycli.yaml配置文件，你可以利用这个机制设置默认参数。 -
错误处理：可以通过
cmd.Execute()返回的 error 来统一处理异常情况，避免 panic。 -
打包发布：使用
go build编译后，将二进制文件放入系统路径（如/usr/local/bin）即可全局调用。
基本上就这些了。cobra 提供的功能远不止这些，但上面的内容已经足够让你写出一个像样的 CLI 工具。后续可以根据需求慢慢扩展，比如添加日志、配置管理、远程 API 调用等功能。CLI 开发本身不复杂，但很容易忽略细节，比如参数校验、错误提示、帮助文档等，这些才是用户体验的关键。
