Go语言flag包用于解析命令行参数,支持字符串、整数、布尔等类型,通过flag.String、flag.Int、flag.Bool定义参数,默认值和描述,调用flag.Parse()解析输入,未解析参数保留在os.Args中;支持短选项(如-v)和默认值设置,布尔类型可直接用开关形式;不支持组合短选项(如-abc);通过实现flag.Value接口可扩展自定义类型,如切片;自动提供-help支持,可自定义flag.Usage输出格式,解析失败时自动报错并显示用法。

Go 语言内置的 flag 包是开发命令行工具的核心组件,它能帮助我们轻松解析用户输入的参数。使用 flag 不仅简洁高效,还能自动生成帮助信息,适合构建轻量级 CLI 工具。
基本用法:定义和解析参数
flag 支持布尔、字符串、整数等常见类型。你需要先定义变量来接收参数值,然后调用 flag.Parse() 启动解析。
- 使用 flag.String、flag.Int、flag.Bool 定义参数,默认值和描述
- 调用 flag.Parse() 开始解析命令行输入
- 未被 flag 解析的参数会保留在后续 os.Args 中
示例:
var name = flag.String("name", "World", "问候对象")
var verbose = flag.Bool("v", false, "是否开启详细输出")
func main() {
flag.Parse()
if *verbose {
fmt.Println("详细模式已开启")
}
fmt.Printf("Hello, %s!\n", *name)
}
运行:go run main.go -name=Alice -v 输出带详细信息的问候语。
立即学习“go语言免费学习笔记(深入)”;
支持短选项与默认值
flag 允许为参数设置短形式(如 -v 对应 --verbose),提升用户体验。同时每个参数都应提供合理默认值,保证程序在无参时也能运行。
- 短选项通过相同名称注册即可,比如 -n 和 --name 都指向 name 变量
- 默认值在 flag 定义时指定,用户不传则使用默认
- 布尔类型支持开关式写法,-v 即表示 true
注意:Go 的 flag 不支持组合短选项(如 -abc),只能单独使用 -a -b -c。
自定义类型与复杂参数
对于切片或自定义结构体参数,flag 原生不直接支持,但可通过实现 flag.Value 接口扩展。
例如,接收多个文件路径:
type stringsValue []string
func (s *stringsValue) Set(val string) error {
*s = append(*s, val)
return nil
}
func (s *stringsValue) String() string {
return fmt.Sprintf("%v", []string(*s))
}
var files stringsValue
flag.Var(&files, "file", "添加处理文件(可多次使用)")
这样就可以多次传入 -file 参数收集多个值。
生成帮助文档与错误处理
flag 自动集成 help 支持。调用 -h 或 --help 会打印所有注册参数及其说明。你也可以自定义 Usage 函数优化输出格式。
flag.Usage = func() {
fmt.Fprintf(os.Stderr, "Usage: %s [options]\n", os.Args[0])
flag.PrintDefaults()
}
当参数解析失败时(如类型不匹配),flag 会自动报错并调用 Usage。你可以捕获这部分逻辑做更友好的提示。
基本上就这些。熟练掌握 flag 能让你快速写出专业感十足的命令行工具,无需依赖外部库。










