理解Go语言组件flag

作用

主要用来实现命令行的参数解析，以达到实现以下效果的目的

$ cmd -flagname 123

使用方式

flag是Go语言的内置包，能接收的参数类型主要有字符串、布尔和数值类型。

方式一

func main() {
  var ip = flag.String("ip", "127.0.0.1", "此处传入IP地址")
  flag.Parse()
  fmt.Println(*ip)
}

我们在main函数中调用flag.String函数来定义命令，该函数共有三个参数

• 第一个参数是命令名称
• 第二个参数为默认值，也就是不传ip时默认拿到的值
• 第三个参数是给用户的提示

同时该函数返回的是指针类型，打印变量ip时记得加上指针符号来输出地址对应的值。在执行flag.String后，记得执行flag.Parse来解析命令，否则不能执行成功。我们来测试一下，先键入一个错的参数，会得到以下提示。

go run main.go -i

flag provided but not defined: -i
Usage of /var/folders/3s/5v6r481x17x5ks_7q1dzmlsw0000gp/T/go-build400337564/b001/exe/main:
  -ip string
        此处传入IP地址 (default "127.0.0.1")

加上-ip参数和值，可以直接获取到对应的值

go run main.go -ip 192.168.1.1

192.168.1.1

除了-ip 192.168.1.1这种形式外，以等号赋值的方式也是支持的

go run main.go -ip=192.168.1.1

192.168.1.1

现在什么都不传，可以直接拿到设置的默认值

go run main.go

127.0.0.1

方式二

除上述内容之外，还有一种写法，我们再增加一个端口号为例

var port int

func init() {
	flag.IntVar(&port, "port", 80, "端口号")
}

func main() {
	flag.Parse()
	fmt.Println("port", port)
}

首先定义一个整型变量port，在init函数中调用flag.IntVar函数，该函数与flag.String相比，少了返回值，且多一个参数，第一个参数是预先定义好的变量，为了方便IntVar内部修改变量值，所以该参数传引用类型。

方式三

如果我们想在接收参数值的过程当中做一些处理，那么也可以自己进行实现。假如我们需要对传入的用户名user进行处理，加上一个_suffix后缀。

type user string

func (u *user) String() string {
	return fmt.Sprint(*u)
}

func (u *user) Set(value string) error {
	if len(value) < 3 {
		return errors.New("姓名长度不得小于3位")
	}
	*u = user(value + "_suffix")
	return nil
}

首先需要定义一个类型，然后实现两个方法String与Set，在Set方法中我对传入的值进行了长度判断，如果小于3个字符就抛出错误，否则就将传入的值拼接一个后缀_suffix。

var userFlag user

func main() {
	flag.Var(&userFlag, "user", "用户名")
	flag.Parse()
	fmt.Println(userFlag)
}

接下来定义一个user类型的变量，然后在main函数中调用flag.Var方法，将变量地址传入，接下来执行命令做测试。

go run flagVar.go -user pingye
pingye_suffix

成功拼接上了后缀。

Go语言组件学习示例开源库，欢迎star

https://github.com/EnochZg/golang-examples