Go 的 flag 包需显式调用 flag.String、flag.Int 等注册基础参数并保存返回指针；自定义类型须实现 flag.Value 接口（Set 和 String 方法）；flag.Parse() 前必须完成注册，且子命令需用 flag.NewFlagSet 手动管理。
如何用 flag 包定义字符串、整数、布尔等基础参数
Go 的 flag 包默认只支持基础类型，必须显式声明变量并调用 flag.String、flag.Int、flag.Bool 等函数注册。不能像 Python 的 argparse 那样靠类型推导自动绑定。
常见错误是直接传字面量（比如 flag.String("name", "default", "")）却不保存返回值——这会导致参数解析后无法读取，因为返回的是指向内部变量的指针，不存下来就丢了。
- 必须用变量接收返回值：
name := flag.String("name", "guest", "user name") - 所有
flag.Xxx调用必须在flag.Parse()之前完成，否则参数不会被识别 - 短选项（如
-v）和长选项（如--verbose）需分别注册，flag不自动映射
如何支持自定义类型参数（比如时间格式、枚举、IP 地址）
当需要解析 --deadline 2025-03-15T14:00:00Z 或 --level debug 这类非基础类型时，得实现 flag.Value 接口，而不是靠类型断言或手动转换。
核心是实现两个方法：Set(string) error 和 String() string。前者负责把命令行字符串转为目标值，后者用于打印默认值（比如帮助信息里显示）。
立即学习“go语言免费学习笔记（深入）”；
使用四维度框架评估任意 GitLab MR 或 GitHub PR 的复杂度：规模（20%），认知负荷（30%），审查工作量（30%），风险/影响（20%）...
- 不要在
Set中 panic，必须返回明确的error，否则flag会静默失败 - 如果类型有多个合法格式（如时间支持 RFC3339 和 Unix 时间戳），
Set内部要覆盖全部分支并统一返回错误提示 - 注册时用
flag.Var，不是flag.String：var deadline time.Time flag.Var(&deadline, "deadline", "task deadline (RFC3339)")
为什么 flag.Parse() 后取不到参数值？常见陷阱排查
最典型的现象是：程序运行不报错，但 *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 实现（类似 git commit、git push）
标准 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 行为
真正难的不是注册几个 flag，而是让错误提示清晰、帮助信息对齐实际行为、子命令间参数隔离不污染。这些细节不写进文档，但用户一用就卡住。
