Go标准库flag包提供轻量高效类型安全的命令行参数解析,支持字符串、整数、布尔等类型及默认值和帮助文本;需先声明参数再调用flag.Parse()解析,支持自定义Usage和开关式参数。

Go 标准库 flag 包提供了轻量、高效且类型安全的命令行参数解析能力,支持字符串、整数、布尔等基本类型,并可方便设置默认值和使用说明。
定义参数并设置默认值
使用 flag.String、flag.Int、flag.Bool 等函数声明参数,参数名、默认值、帮助文本为必填项。返回的是对应类型的指针,便于后续取值。
host := flag.String("host", "localhost", "server host address")port := flag.Int("port", 8080, "server port number")debug := flag.Bool("debug", false, "enable debug mode")
解析命令行输入
在所有参数定义完成后,调用 flag.Parse() 才会真正读取 os.Args[1:] 并赋值。未提供的参数将自动使用默认值。
- 若用户执行
./app -port 3000,则*port == 3000,*host == "localhost",*debug == false - 若传入未知 flag(如
-timeout),程序会自动打印错误并退出
访问参数值与自定义用法提示
通过解引用指针获取值,例如 fmt.Println("Host:", *host)。如需自定义帮助信息,可设置 flag.Usage 函数,在用户输入 -h 或 --help 时触发。
立即学习“go语言免费学习笔记(深入)”;
flag.Usage = func() { fmt.Fprintf(os.Stderr, "Usage: %s [options]\n", os.Args[0]); flag.PrintDefaults() }-
flag.PrintDefaults()会按定义顺序输出所有 flag 及其默认值和说明
支持非布尔类型的“开关式”参数(如 -v)
标准 flag.Bool 需显式写 -debug=true 或 -debug=false。若想支持简写开关(如 -v 表示 true,不加即 false),可用 flag.BoolVar 配合自定义逻辑:
- 声明变量:
var verbose bool - 绑定 flag:
flag.BoolVar(&verbose, "v", false, "verbose output") - 此时
-v自动设为true,不加该 flag 则保持初始值false
不复杂但容易忽略:所有 flag.Xxx 调用必须在 flag.Parse() 前完成;否则参数不会被识别。另外,flag 解析只处理 -x 和 --x 形式,不支持 x= 这类赋值语法。










