Golang编写首个命令行工具：flag与os.Args详解

学习Golang命令行参数处理，首选os.Args和flag包。1. os.Args适合获取简单、少量的参数，直接以字符串切片形式提供所有输入参数；2. flag包适合需要结构化解析的场景，支持类型化参数定义及标准格式（如-name=value），并可获取未被解析的位置参数。选择依据：参数少且无需复杂解析时用os.Args，参数多或需规范格式与默认值时用flag包。

写命令行工具是学习任何语言时都很重要的一环，Golang 提供了两种常见方式来处理命令行参数：os.Args 和 flag 包。两者各有适用场景，本文就带你看看它们怎么用。

os.Args：最基础的参数获取方式

如果你只是想快速拿到命令行传进来的参数，os.Args 是最直接的方式。它是一个字符串切片，里面包含了执行命令时的所有参数。

举个例子：

go run main.go config.json --verbose

对应的 os.Args 就会是：

[]string{"main.go", "config.json", "--verbose"}

• 第一个元素是程序名（或脚本路径）
• 后面的是按空格分隔的参数

这种方式适合参数简单、不需要复杂解析的情况。比如你只需要读取一个文件路径，或者判断有没有某个关键词。

缺点也很明显：
如果参数多了，自己手动判断顺序和格式会比较麻烦，这时候就需要更强大的工具。

flag 包：结构化参数解析利器

当你需要支持 -name=value 或 --name value 这类参数格式时，推荐使用标准库中的 flag 包。

基本用法

你可以定义各种类型的参数，例如字符串、布尔值等：

package main

import (
    "flag"
    "fmt"
)

func main() {
    var name string
    var verbose bool

    flag.StringVar(&name, "name", "default", "输入名称")
    flag.BoolVar(&verbose, "verbose", false, "是否开启详细模式")

    flag.Parse()

    fmt.Println("Name:", name)
    fmt.Println("Verbose:", verbose)
}

运行示例：

go run main.go -name=Tom -verbose

输出：

Name: Tom
Verbose: true

这样就可以很清晰地处理各种命令行参数了。

支持的位置参数（非flag部分）

flag.Parse() 之后，还可以通过 flag.Args() 获取没有被解析为 flag 的剩余参数。

比如上面的例子中，如果执行：

go run main.go -name=Tom extraArg1 extraArg2

那么 flag.Args() 返回的就是 ["extraArg1", "extraArg2"]。

什么时候该选哪个？

• 选 os.Args 的情况：

  • 参数非常少，甚至只有一个
  • 不关心参数顺序或格式
  • 快速原型验证，不追求规范性

• 选 flag 的情况：

  • 需要支持 -flag=value 这样的标准格式
  • 参数多，有默认值、帮助信息需求
  • 工具希望看起来“专业”一点

当然，还有第三方包比如 pflag（支持长短选项）和 cobra（构建完整 CLI 工具），但如果是你的第一个命令行工具，建议先掌握好标准库。

基本上就这些。这两种方法都不难，但理解清楚各自适用场景会让你在开发初期少走弯路。