Golang如何定义自定义命令行参数_flag包实战说明_技术教程

Go 的 flag 包需显式调用 flag.String、flag.Int 等注册基础参数并保存返回指针；自定义类型须实现 flag.Value 接口（Set 和 String 方法）；flag.Parse() 前必须完成注册，且子命令需用 flag.NewFlagSet 手动管理。

Go 的 flag 包默认只支持基础类型，必须显式声明变量并调用 flag.String、flag.Int、flag.Bool 等函数注册。不能像 Python 的 argparse 那样靠类型推导自动绑定。

常见错误是直接传字面量（比如 flag.String("name", "default", "")）却不保存返回值——这会导致参数解析后无法读取，因为返回的是指向内部变量的指针，不存下来就丢了。

必须用变量接收返回值：

name := flag.String("name", "guest", "user name")

当需要解析 --deadline 2025-03-15T14:00:00Z 或 --level debug 这类非基础类型时，得实现 flag.Value 接口，而不是靠类型断言或手动转换。

核心是实现两个方法：Set(string) error 和 String() string。前者负责把命令行字符串转为目标值，后者用于打印默认值（比如帮助信息里显示）。

注册时用 flag.Var，不是 flag.String：

var deadline time.Time
flag.Var(&deadline, "deadline", "task deadline (RFC3339)")

最典型的现象是：程序运行不报错，但 *name 始终是空字符串或零值。问题往往不在解析逻辑，而在变量生命周期或调用时机。

flag.Parse() 只解析 os.Args[1:]，如果你手动修改了 os.Args（比如切片或重赋值），必须在 flag.Parse() 前完成
如果用 flag.CommandLine = flag.NewFlagSet(...) 创建了子命令，记得用对应实例的 Parse()，而非全局 flag.Parse()
包级变量和局部变量混用容易出错：在 init() 函数里注册 flag 是安全的；但在某个函数内注册后又在另一函数里调用 flag.Parse()，可能因执行顺序导致未注册
帮助信息（-h / --help）由 flag.PrintDefaults() 控制，但默认只在解析失败且含未知 flag 时触发——想主动支持 -h，得自己加判断：
```
if *help {
    flag.PrintDefaults()
    os.Exit(0)
}
```

标准 flag 包本身不

提供子命令抽象，得靠 flag.NewFlagSet 手动模拟。关键在于：主命令解析完第一个非 flag 参数后，把剩余参数交给对应子命令的 FlagSet 处理。

注意子命令的 FlagSet 默认不继承父级的 usage 和 error handler，需要显式设置，否则 -h 输出会不一致或 panic。

子命令参数从 os.Args[2:] 开始（假设 os.Args[1] 是子命令名），传给子 FlagSet.Parse()
每个子命令应有自己的 FlagSet 实例，避免 flag 名称冲突（比如 commit -m 和 push -m 可能含义不同）
错误处理建议统一：设置 fs.SetOutput(os.Stderr) 并捕获 fs.Parse() 返回的 error，不要依赖全局 flag 的 panic 行为