用Golang开发第一个CLI工具教程

本文介绍了如何用 Go 编写一个简单的 CLI 工具，具体步骤包括：1. 从 main 函数开始构建基础程序结构；2. 使用 os.Args 接收并处理命令行参数；3. 利用 flag 包规范地解析带选项的参数；4. 扩展功能如实现数字相加操作。通过这些步骤，初学者可以逐步掌握 CLI 工具开发的核心概念，并为进一步开发更复杂的功能打下基础。

写一个简单的 CLI 工具是很多 Golang 初学者的入门项目。它不复杂，但能帮助你理解命令行参数、程序结构和基本输入输出操作。今天我们来一步步用 Go 实现一个最基础的 CLI 工具。

基本结构：从 main 函数开始

Go 程序的入口是 main 包中的 main 函数。要写一个 CLI 工具，第一步就是创建一个 main.go 文件，并定义这个函数：

package main

import "fmt"

func main() {
    fmt.Println("Hello from my first CLI tool!")
}

运行这个程序很简单，在终端里执行：

go run main.go

如果你想生成一个可执行文件，可以用：

go build -o mycli
./mycli

这样你就有了一个可以运行的命令行工具了，虽然目前只能打印一句话。

接收命令行参数：让工具更灵活

CLI 工具之所以有用，是因为它可以接受用户输入的参数。在 Go 中，我们可以通过 os.Args 来获取这些参数：

package main

import (
    "fmt"
    "os"
)

func main() {
    args := os.Args
    fmt.Println("Arguments:", args)
}

运行时传入参数看看效果：

./mycli hello world

你会看到输出类似：

Arguments: [./mycli hello world]

第一个元素是程序名，后面的是用户输入的参数。你可以根据需要解析这些参数，比如实现一个 --help 的判断：

if len(args) > 1 && args[1] == "--help" {
    fmt.Println("Usage: mycli ")
}

不过手动处理参数会比较麻烦，特别是当参数变多或有 flag（如 -v）时。这时候你可以考虑使用标准库里的 flag 包或者第三方库如 spf13/cobra。

使用 flag 包解析参数：更规范地处理输入

Go 标准库中的 flag 包可以帮你处理带选项的参数，比如 -name=value 或者 -v 这样的形式。

举个例子，假设我们要做一个简单的打招呼命令：

package main

import (
    "flag"
    "fmt"
)

func main() {
    name := flag.String("name", "World", "a name to greet")
    flag.Parse()
    fmt.Printf("Hello, %s!\n", *name)
}

编译后运行：

./mycli -name=Alice

输出就会变成：

Hello, Alice!

flag 包的好处是不需要引入外部依赖，适合小型 CLI 工具。如果你的工具有多个子命令，建议考虑 cobra。

加点小功能：让工具更有用

我们可以给这个工具加一个小功能，比如计算两个数的和。先来看怎么接收数字参数：

num1 := flag.Int("a", 0, "first number")
num2 := flag.Int("b", 0, "second number")
flag.Parse()

fmt.Printf("%d + %d = %d\n", *num1, *num2, *num1+*num2)

这样就可以通过命令行运行：

./mycli -a=3 -b=5

结果输出：

3 + 5 = 8

当然这只是个简单例子，你可以扩展出更多实用的功能，比如文件操作、网络请求等。

基本上就这些。CLI 工具开发起来不难，但想做得好也需要注意参数设计、错误处理和用户体验。刚开始不用追求完美，先把功能跑起来再说。