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

用Golang开发首个CLI工具教程

2025-08-14 12:52:30 0浏览收藏

最近发现不少小伙伴都对Golang很感兴趣，所以今天继续给大家介绍Golang相关的知识，本文《用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)

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