Go语言标准库中的
flag包提供了简洁高效的命令行参数解析功能，适合构建命令行工具。它支持布尔、整型、字符串等常见类型，并能自动生成帮助信息。掌握其基本用法与进阶技巧，能显著提升CLI程序的可用性与可维护性。
基本参数定义与解析
使用
flag定义参数主要有两种方式：一种是通过
flag.Type函数返回指针，另一种是使用
flag.TypeVar绑定已有变量。
name := flag.String("name", "default", "用户姓名")—— 定义字符串参数，默认值为"default"age := flag.Int("age", 0, "用户年龄")—— 定义整型参数active := flag.Bool("active", false, "是否激活")—— 定义布尔参数
定义完成后调用
flag.Parse()开始解析。解析后，可通过指针获取值，如
*name。
自定义参数类型与Var方法
对于复杂类型（如切片、自定义结构），可实现
flag.Value接口：包含
String()和
Set(string)两个方法。
立即学习“go语言免费学习笔记（深入）”；
- 定义一个字符串切片类型，支持多次传参（如
-tag go -tag web
） - 实现
Set
方法将输入追加到切片中 - 使用
flag.Var(&tags, "tag", "标签列表")
注册
这种方式灵活，适用于日志级别、过滤标签等场景。
子命令与flag.Args处理
当程序支持多个子命令（如
git clone、
git push）时，可在主
flag.Parse()后判断
flag.NArg()，取出第一个非flag参数作为子命令名。
例如：
- 调用
flag.Parse()
后，用flag.Args()
获取剩余参数 - 根据
args := flag.Args(); cmd := args[0]
分发逻辑 - 为每个子命令定义独立的
flag.FlagSet
，避免参数冲突
每个
FlagSet可单独调用
Parse，实现模块化参数管理。
使用技巧与最佳实践
提升用户体验和代码可读性的几个关键点：
- 布尔参数支持
--verbose
或--verbose=true
，也可用-v
简写 - 通过
flag.CommandLine.SetOutput(os.Stderr)
将帮助信息输出到标准错误 - 使用
flag.Usage = func(){...}自定义帮助输出格式 - 参数名尽量使用小写，避免与Go关键字冲突
- 默认值应在帮助文本中清晰体现
基本上就这些。合理使用
flag能让命令行工具既强大又易用，无需引入第三方库即可满足大多数场景需求。
