当前位置：首页 > 文章列表 > Golang > Go教程 > 用Golang写第一个CLI工具教程

用Golang写第一个CLI工具教程

2025-07-31 20:36:30 0浏览收藏

本教程面向 Golang 初学者，旨在引导大家快速上手开发命令行界面 (CLI) 工具。文章从构建基础程序结构入手，详细讲解了如何利用 `os.Args` 接收和处理命令行参数，并深入探讨了 `flag` 包的使用，以便更规范地解析带选项的参数。通过一个简单的数字相加示例，读者将能够掌握 CLI 工具开发的核心概念，为构建更复杂的功能打下坚实基础。本文将帮助你从零开始，一步步实现你的第一个 Golang CLI 工具，让你轻松入门，并为后续的进阶开发做好准备。

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

如何用Golang实现第一个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 <command>")
}

不过手动处理参数会比较麻烦，特别是当参数变多或有 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)

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