如何用Golang实现第一个CLI工具手把手教你开发命令行应用-Golang-PHP中文网

如何用Golang实现第一个CLI工具手把手教你开发命令行应用

P粉602998670

发布： 2025-07-18 10:04:02

原创

680人浏览过

本文介绍了如何用 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语言免费学习笔记（深入）”；

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。

KAIZAN.ai

使用AI来改善客户服体验，提高忠诚度

查看详情

使用 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)

登录后复制

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