1. 参数解析说明

import "flag"

flag 包实现了命令行参数的解析。每个参数认为一条记录，根据实际进行定义，到一个 set 集合。每条都有各自的状态参数。

使用 flag 的正常流程为：

通过 flag.String() ， flag.Bool() ， flag.Int() 等函数来定义命令行中需要使用的参数；
在定义完 flag 命令行参数后，通过调用 flag.Parse() 来进行对命令行参数的解析；
获取 flag.String() ，flag.Bool() ， flag.Int() 等方法的返回值，即对应用户输入的参数；

需要注意的是：

flag.Xxx() 返回的值是变量的内存地址，要获取值时要通过在变量前加 * 获取。

flag.Int 、 flag.Bool 、 flag.String 这样的函数格式都是一样的，调用的时候需要传入 3 个参数

func Int(name string, value int, usage string) *int
func Bool(name string, value bool, usage string) *bool
func String(name string, value string, usage string) *string

name 表示命令行参数的名称， value 表示命令行参数的值， usage 表示命令行参数的说明和描述。
其它可注册的 flag 类型有：
Bool / Int / Int64 / Uint / Uint64 / Float / Float64 / String / Duration / Var

最简单的代码示例：

package main// 导入系统包
import ("flag""fmt"
)// 定义命令行参数
var mode = flag.String("mode", "", "process mode")
var num = flag.Int("num", 5, "process number")
var isProcess = flag.Bool("isProcess", true, "process bool")func main() {// 解析命令行参数flag.Parse()// 输出命令行参数fmt.Println(*mode)fmt.Println(*num)fmt.Println(*isProcess)
}

运行结果：

wohu@wohu:~/gocode/src$ go run hello.go -h
Usage of /tmp/go-build314506183/b001/exe/hello:-isProcessprocess bool (default true)-mode stringprocess mode-num intprocess number (default 5)
exit status 2
wohu@wohu:~/gocode/src$ go run hello.go  -mode="hello,world" -num=10
hello,world
10
true
wohu@wohu:~/gocode/src$

命令行 flag 语法：

-flag
-flag=x
-flag x  // 只有非bool类型的flag可以

可以使用 1 个或 2 个 - 号，效果是一样的。最后一种格式不能用于 bool 类型的 flag ，因为如果有文件名为 0、 false 等时,如下命令：

cmd -x *

其含义会改变。你必须使用 -flag=false 格式来关闭一个 bool 类型 flag 。
整数flag接受1234、0664、0x1234等类型，也可以是负数。bool类型flag可以是：

1, 0, t, f, T, F, true, false, TRUE, FALSE, True, False

注意： go run hello.go -mode="hello,world" -num=10 命令行中，可以是 --num=10 但不能是 --num==10 。

2. 数据结构和函数

2.1 type Flag

type Flag struct {Name     string // flag在命令行中的名字Usage    string // 帮助信息Value    Value  // 要设置的值DefValue string // 默认值（文本格式），用于使用信息
}

Flag 类型代表一条 flag 的状态。

2.2 type FlagSet

type FlagSet struct {// Usage函数在解析flag出现错误时会被调用// 该字段为一个函数（而非采用方法），以便修改为自定义的错误处理函数Usage func()// 内含隐藏或非导出字段
}

FlagSet 代表一个已注册的 flag 的集合。 FlagSet 零值没有名字，采用 ContinueOnError 错误处理策略。

在 flag 包中，进行了进一步封装：将 FlagSet 的方法都重新定义了一遍，也就是提供了一序列函数，而函数中只是简单的调用已经实例化好了的 FlagSet 。

所以我们只需要关注 flag 中的函数即可，它会自动调用 FlagSet 中的函数。

2.3 func NFlag

func NFlag() int

NFlag 返回已被设置的 flag 的数量。

2.4 func Lookup

func Lookup(name string) *Flag

返回已经已注册 flag 的 Flag 结构体指针；如果 flag 不存在的话，返回 nil 。

2.5 func NArg

func NArg() int

NArg 返回解析 flag 之后剩余参数的个数。

2.6 func Args

func Args() []string

返回解析之后剩下的非 flag 参数。（不包括命令名）也就是说无法进行flag匹配的有哪些参数。

2.7 func Arg

func Arg(i int) string

返回解析之后剩下的第 i 个参数，从 0 开始索引。

2.8 func PrintDefaults

func PrintDefaults()

PrintDefault 会向标准错误输出写入所有注册好的 flag 的默认值。

2.9 func Bool

func Bool(name string, value bool, usage string) *bool

Bool 用指定的名称、默认值、使用信息注册一个 bool 类型 flag 。返回一个保存了该 flag 的值的指针。

2.10 func BoolVar

func BoolVar(p *bool, name string, value bool, usage string)

BoolVar 用指定的名称、默认值、使用信息注册一个 bool 类型 flag ，并将 flag 的值保存到 p 指向的变量。

2.11 func Int

func Int(name string, value int, usage string) *int

Int 用指定的名称、默认值、使用信息注册一个 int 类型 flag 。返回一个保存了该 flag 的值的指针。

2.12 func IntVar

func IntVar(p *int, name string, value int, usage string)

IntVar 用指定的名称、默认值、使用信息注册一个 int 类型 flag ，并将 flag 的值保存到 p 指向的变量。

2.13 func Int64

func Int64(name string, value int64, usage string) *int64

Int64 用指定的名称、默认值、使用信息注册一个 int64 类型 flag 。返回一个保存了该 flag 的值的指针。

2.14 func Int64Var

func Int64Var(p *int64, name string, value int64, usage string)

Int64Var 用指定的名称、默认值、使用信息注册一个 int64 类型 flag ，并将 flag 的值保存到 p 指向的变量。

2.15 func Uint

func Uint(name string, value uint, usage string) *uint

Uint 用指定的名称、默认值、使用信息注册一个 uint 类型 flag 。返回一个保存了该 flag 的值的指针。

2.16 func UintVar

func UintVar(p *uint, name string, value uint, usage string)

UintVar 用指定的名称、默认值、使用信息注册一个 uint 类型 flag ，并将 flag 的值保存到 p 指向的变量。

2.17 func Uint64

func Uint64(name string, value uint64, usage string) *uint64

Uint64 用指定的名称、默认值、使用信息注册一个 uint64 类型 flag 。返回一个保存了该 flag 的值的指针。

2.18 func Uint64Var

func Uint64Var(p *uint64, name string, value uint64, usage string)

Uint64Var 用指定的名称、默认值、使用信息注册一个 uint64 类型 flag ，并将 flag 的值保存到 p 指向的变量。

2.19 func Float64

func Float64(name string, value float64, usage string) *float64

Float64 用指定的名称、默认值、使用信息注册一个 float64 类型 flag 。返回一个保存了该 flag 的值的指针。

2.20 func Float64Var

func Float64Var(p *float64, name string, value float64, usage string)

Float64Var 用指定的名称、默认值、使用信息注册一个 float64 类型 flag ，并将 flag 的值保存到 p 指向的变量。

2.21 func String

func String(name string, value string, usage string) *string

String 用指定的名称、默认值、使用信息注册一个 string 类型 flag 。返回一个保存了该 flag 的值的指针。

2.22 func StringVar

func StringVar(p *string, name string, value string, usage string)

StringVar 用指定的名称、默认值、使用信息注册一个 string 类型 flag ，并将 flag 的值保存到 p 指向的变量。

2.23 func Duration

func Duration(name string, value time.Duration, usage string) *time.Duration

Duration 用指定的名称、默认值、使用信息注册一个 time.Duration 类型 flag 。返回一个保存了该 flag 的值的指针。

2.24 func DurationVar

func DurationVar(p *time.Duration, name string, value time.Duration, usage string)

DurationVar 用指定的名称、默认值、使用信息注册一个 time.Duration 类型 flag ，并将 flag 的值保存到 p 指向的变量。

2.25 func Var

func Var(value Value, name string, usage string)

Var 方法使用指定的名字、使用信息注册一个 flag 。该 flag 的类型和值由第一个参数表示，该参数应实现了 Value 接口。例如，用户可以创建一个 flag ，可以用 Value 接口的 Set 方法将逗号分隔的字符串转化为字符串切片。

2.26 func Set

func Set(name, value string) error

设置已注册的 flag 的值。

2.27 func Parse

func Parse()

从 os.Args[1:] 中解析注册的 flag 。必须在所有 flag 都注册好而未访问其值时执行。未注册却使用 flag -help 时，会返回 ErrHelp 。

2.28 func Parsed

func Parsed() bool

返回是否 Parse 已经被调用过。

2.29 func Visit

func Visit(fn func(*Flag))

按照字典顺序遍历标签，并且对每个标签调用 fn 。这个函数只遍历解析时进行了设置的标签。

2.30 func VisitAll

func VisitAll(fn func(*Flag))

按照字典顺序遍历标签，并且对每个标签调用 fn 。这个函数会遍历所有标签，不管解析时有无进行设置。

3. 代码示例

3.1 解析 flag 参数为指针

package mainimport ("flag""fmt"
)// 定义命令行参数
var mode = flag.String("mode", "", "process mode")
var num = flag.Int("num", 5, "process number")
var isProcess = flag.Bool("isProcess", true, "process bool")func main() {// 未解析时查看已设置的 flag 数量registerNum := flag.NFlag()fmt.Printf("Before Parse registerNum is %#v\n", registerNum)// Before Parse registerNum is 0// 解析命令行参数flag.Parse()registerNum = flag.NFlag()fmt.Printf("After Parse registerNum is %#v\n", registerNum)// After Parse registerNum is 3// 无法进行flag匹配的有哪些参数flagArgs := flag.Args()fmt.Printf("flagArgs is %#v\n", flagArgs)// 输出命令行参数fmt.Println(*mode)    // 必须加 * 号fmt.Println(*num)fmt.Println(*isProcess)
}