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

用Golang开发首个CLI工具教程

2025-08-26 11:11:35 0浏览收藏

想知道如何快速上手 Golang 命令行应用开发吗？本文将手把手教你用 Go 语言实现你的第一个 CLI 工具！从构建基础程序结构开始，到利用 `os.Args` 接收并处理命令行参数，再到使用 `flag` 包规范地解析带选项的参数，本文将一步步引导你掌握 CLI 工具开发的核心概念。我们还将扩展工具的功能，例如实现数字相加操作，让你快速了解 CLI 工具的开发流程。无论你是 Golang 初学者还是有一定经验的开发者，都能通过本文轻松入门 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)

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