flag.parse() 后无法捕获错误，因默认调用 os.exit(2)；须在调用前设 flag.commandline.init("myapp", flag.continueonerror)，再手动检查 parse 返回值。
flag.Parse() 后无法捕获解析错误？
Go 的 flag 包默认在解析失败时直接调用 os.Exit(2)，根本不会把控制权交还给你——这意味着你写在 flag.Parse() 后面的错误处理逻辑压根不会执行。
解决办法只有一个：提前接管错误出口。在 flag.Parse() 前调用 flag.CommandLine.Init("myapp", flag.ContinueOnError)，并手动检查返回值：
flag.CommandLine.Init("myapp", flag.ContinueOnError)
err := flag.CommandLine.Parse(os.Args[1:])
if err != nil {
// 这里才能真正拿到错误，比如 "flag provided but not defined: -x"
log.Fatal(err)
}
- 必须在
flag.Parse()之前调用Init()，否则无效 -
flag.ContinueOnError是关键，flag.PanicOnError或默认行为都会中断流程 -
flag.CommandLine是全局实例，修改它会影响所有未显式创建的FlagSet
自定义 Usage 输出不生效？
很多人设了 flag.Usage = func(){...} 却发现 help 提示还是默认格式——问题出在触发时机：只有当 flag.Parse() 遇到 -h、--help 或解析失败且未禁用 exit 时，才会自动调用 Usage。
更可靠的做法是主动控制输出时机，并复用 flag.PrintDefaults()：
立即学习“go语言免费学习笔记（深入）”；
flag.Usage = func() {
fmt.Fprintf(os.Stderr, "Usage: %s [flags] <input-file>\n", os.Args[0])
fmt.Fprintf(os.Stderr, "\nFlags:\n")
flag.PrintDefaults()
}
// 然后在解析后手动判断是否要显示 help
if *helpFlag {
flag.Usage()
os.Exit(0)
}
- 不要依赖
-h自动触发；显式定义helpbool flag 更可控 -
flag.PrintDefaults()只打印已声明的 flag，且格式固定，别试图重写它 - 输出必须写到
os.Stderr，和标准 flag 行为一致，避免管道场景下输出错乱
多个 FlagSet 共存时 Usage 冲突？
当项目有子命令（如 myapp serve、myapp migrate）时，用多个独立 flag.FlagSet 是正解，但每个都要单独配 Usage，且不能共用 flag.CommandLine。
典型结构：
rootFS := flag.NewFlagSet("root", flag.ContinueOnError)
serveFS := flag.NewFlagSet("serve", flag.ContinueOnError)
// 每个 FlagSet 都要单独设 Usage
rootFS.Usage = func() { ... }
serveFS.Usage = func() { ... }
// 解析时指定目标 FlagSet
if len(os.Args) > 1 && os.Args[1] == "serve" {
err := serveFS.Parse(os.Args[2:])
if err != nil && err != flag.ErrHelp {
log.Fatal(err)
}
}
- 切勿对不同
FlagSet复用同一个Usage函数，参数说明和上下文完全不同 -
flag.ErrHelp是特殊错误值，表示用户主动请求 help，此时不应报错退出 - 子命令解析后，
serveFS.Args()返回的是子命令后的剩余参数，不是全局os.Args
bool flag 默认值显示混乱？
用 flag.Bool("verbose", false, "show debug info") 声明后，flag.PrintDefaults() 会显示 -verbose=false，但用户直觉是“不加就是关”，加了才是开——这个 =false 不仅多余，还容易引发误解。
正确做法是省略默认值描述，靠文档或 help 文本说明语义：
verbose := flag.Bool("verbose", false, "enable verbose logging (default: false)")
- 不要写
-verbose=true这种用法，Go flag 对 bool 的设计是 presence-based：出现即 true，不出现即 false - 如果硬要支持
--verbose=true形式，得用flag.String+ 手动解析，代价远大于收益 - 在 help 文本里明确写出默认行为，比依赖
PrintDefaults()的等号更可靠
Args() 和 NArg() 结果只反映该次解析，别拿它去推断全局参数位置。 
