flag.Parse()必须在定义所有flag后立即调用，否则变量保持零值；flag.StringVar更易测试和绑定字段，flag.String返回指针需解引用；复杂类型需实现flag.Value接口；原生flag不支持子命令，应使用cobra等库。
flag.Parse() 必须在定义完所有 flag 后立即调用
很多人写完 flag.String 或 flag.Int 就直接开始用变量，结果拿到的全是零值。因为 flag 值不是定义时就解析的，而是靠 flag.Parse() 从 os.Args 里真正读取并赋值。不调用它，所有 flag 变量都维持初始值（比如 ""、0、false）。
常见错误现象：flag.String("port", "8080", "") 定义后直接打印，输出还是 "8080" —— 看似对，但其实是默认值，不是用户传的；一旦用户传了 -port 3000 却没调 flag.Parse()，依然输出 "8080"，误以为生效了。
- 必须把所有
flag.Xxx()调用放在flag.Parse()之前 -
flag.Parse()一般放在main()开头，紧接在 flag 定义之后 - 如果提前用了
flag.Arg(i)或flag.NArg()，它们依赖flag.Parse()的副作用，也得等 parse 完再调
flag.String 和 flag.StringVar 的区别不只是写法
表面上只是“返回指针”和“填入已有变量”的差别，但实际影响初始化时机、作用域和测试友好度。
使用场景：想让 flag 值直接绑定到结构体字段或全局配置变量时，用 flag.StringVar 更干净；如果只是临时取值、后续还要做类型转换或校验，用 flag.String 拿指针更灵活。
立即学习“go语言免费学习笔记（深入）”；
参数差异：flag.String("log", "info", "") 返回 *string；flag.StringVar(&cfg.LogLevel, "log", "info", "") 第一个参数是 *string 地址，不返回值。
- 用
flag.String时，记得解引用：比如*logLevel才是真实字符串 - 用
flag.StringVar时，变量必须已声明，且生命周期要覆盖到flag.Parse()之后 - 测试时，
flag.StringVar更容易 mock：直接传个局部变量地址进去就行
自定义 flag.Value 接口才能支持复杂类型（如 slice、map、time.Duration）
内置的 flag.String、flag.Int 等只支持基础类型。想接收多个 -tag foo -tag bar 这种重复 flag，或者 -timeout 30s 这种带单位的值，就必须实现 flag.Value 接口。
常见错误现象：试图用 flag.StringSlice 接收多次 -v，却发现只保留最后一个值——因为没用 flag.StringSliceVar 或没实现累积逻辑。
- 实现
Set(string) error方法，控制每次解析时如何更新内部状态 - 实现
String() string，用于 help 输出和日志打印 - 别忘了在
Set里处理错误，比如time.ParseDuration失败要返回非 nil error，否则 flag 会静默忽略 - Go 标准库的
flag.DurationVar就是这么做的，可参考其源码
flag 无法自动处理子命令（如 git commit / git push）
Go 的 flag 包本身不支持嵌套命令解析。像 mytool serve -port 3000 中的 serve 是普通位置参数，不是子命令；flag.Parse() 一执行，它就被吞进 flag.Args()，后续没法按不同子命令加载不同 flag 集合。
性能 / 兼容性影响：硬用 flag 模拟子命令（比如先手动切 os.Args，再重置 flag.CommandLine）会导致 help 输出混乱、默认 usage 错位、甚至 panic。
- 真需要子命令，用
github.com/spf13/cobra或github.com/alecthomas/kong，它们专为这事设计 - 如果坚持用原生
flag，至少把子命令名提取出来后，用flag.NewFlagSet创建独立解析器，避免污染全局flag.CommandLine - 注意
flag.NewFlagSet默认不解析-help，要手动加.Bool("help", false, "")并检查
最易被忽略的一点：flag 解析失败时（比如类型不匹配），flag.Parse() 会直接调 os.Exit(2)，不会返回错误。如果你在测试或嵌入场景中需要捕获错误，得用 flagset.Parse() 配合自定义 flag.ErrorHandling。
