golang flag 包的使用指北

news2024/10/10 18:26:10

说起 golang 的 flag 个包，我们第一反应的是什么呢？至少我曾经第一次看到 flag 包的时候，第一反应是想起写 C 语言的时候咱们用于定义一个表示的，我们一般会命名为 flag 变量

实际上 golang 的 flag 包是用于处理命令行参数的工具包，我们可以基于这个包来开发自定义的命令行工具

对于命令行，相信大家都不陌生吧，学过 C 的就知道，如下代码是否很熟悉

int main(int argc,char **argv)
{
    // 打印 agrc  和 argv
        return 0;
}

其中 argc 表示命令行的参数个数， argv 二级指针表示实际的命令参数

那么，对于咱们的 golang 是如何玩的，咱们先写个 demo 看看效果

main.go

func main() {
   if len(os.Args) > 0 {
      fmt.Println("len(os.Args) == ", len(os.Args))
      for _, v := range os.Args {
         fmt.Println(v)
      }
   }
}

效果如下：

咱们 go build 输出程序名为 testFlag 的可执行程序，如下运行即可

当然需要看非常详细和全面的关于 flag 包的内容，可以直接查看官方文档，此处咱们是对 flag 包的介绍，平常都会使用到的一些功能，以及注意事项，分别从如下 3 个小点介绍一下常用的功能

绑定 flag 变量

flag.Parse() 的使用方式

注册 flag 和 Flag 解析支持的数据类型

我们可以看到上述简单 demo 演示的是咱们运行可执行程序的时候追加我们期望的参数

实际上我们使用的比较多的是在程序内部去设置 flag，例如一般写 web 服务器的时候，就会去使用 flag 包设置端口

咱们在程序中使用 flag 包，定义一个端口

通过效果，我们可看到，咱们使用 flag 包来设置命令行参数时，实际上返回的是一个指针，这个地方可别弄错了

在我们的代码中，我们可以看到 flag 包他支持这么多数据类型的注册，如下：

基本的 int，int64，uint，uint64 ，整数的 flag 支持这些进制的：1234、0664、0x1234

布尔值，bool ，布尔值可以这样来写：1, 0, t, f, T, F, true, false, TRUE, FALSE, True, False

浮点数，float，float64

字符串，string

时间段 duration 也是支持的很好的，例如：我们可以设置为 100ms，1h，1us，1h25m 等等都是可以的

那么对应到咱们去设置各种数据类型的命令行参数的时候，我们就可以简单的使用 flag 包对应的函数即可，如：

port := flag.Int("port", 8866, "端口")
name := flag.String("name", "小猪", "姓名")
money := flag.Float64("money",10.36,"钱")

其他的照葫芦画瓢就可以了，这些函数的参数都是一样的效果

参数1 flag 名称

参数2 默认值

参数3 帮助信息

这里再来敲一下黑板，上述的 port，name，money 都是指针类型的哦

绑定 flag 变量

如果用不习惯上述方式来注册 flag 的话，我们也是可以先定义一个变量，然后将命令行参数绑定到变量上，如：

var city string
var food string
var age int

flag.StringVar(&city,"city","beijing","城市")
flag.StringVar(&food,"food","roast duck","美食")
flag.IntVar(&age,"age",18,"年龄")

在 flag 包中，我们可以看到也有一堆关于各种数据类型绑定变量的函数