flag.Parse()必须在所有flag.*定义之后调用，否则后续flag不会被解析；短选项需手动注册；位置参数用flag.Args()获取；自定义类型需实现flag.Value接口。
flag.Parse() 必须在所有 flag.* 定义之后调用
很多新手写完 flag.String 或 flag.Int 就直接调用 flag.Parse()，结果发现参数始终是默认值。根本原因是：flag 在定义时只是注册变量，真正赋值发生在 flag.Parse() 执行时，且它只读取已注册的 flag。如果 flag.Parse() 调用太早（比如在定义前或中间），后续定义的 flag 根本不会被解析。
正确顺序必须是：
- 所有
flag.String/flag.Bool/flag.Int等定义完成 - 然后才调用
flag.Parse() - 最后访问变量值
示例错例：
port := flag.Int("port", 8080, "server port")
flag.Parse() // ❌ 太早 —— 此时其他 flag 还没定义
name := flag.String("name", "", "user name") // 这个永远不会被解析
短选项（-h）和长选项（--help）要手动支持
flag 包默认不提供 -h 短选项别名，flag.Bool("help", false, "...") 只响应 --help。如果你希望同时支持 -h 和 --help，得自己注册两个 flag 并共享同一个变量：
- 用指针共享存储：
help := flag.Bool("help", false, "show help")，再加flag.BoolVar(help, "h", false, "show help") - 或者更常见的是：用
flag.BoolVar绑定已有变量，避免重复声明 - 注意：两个 flag 的 usage 文本最好一致，否则
flag.PrintDefaults()会打印两遍
不这么做的话，用户输 ./cmd -h 会报错 flag provided but not defined: -h。
立即学习“go语言免费学习笔记（深入）”；
非 flag 参数（即命令行剩余位置参数）要用 flag.Args() 获取
flag.Parse() 会把第一个非 flag 的参数开始的所有内容截断并存入内部切片，之后调用 flag.Args() 才能拿到它们。这些不是 flag，不能用 flag.String 定义 —— 它们没有键名，纯靠位置。
-
flag.Arg(0)是第一个位置参数，flag.Args()返回[]string全部 - 典型场景：类似
git commit -m "msg"中的"msg"，或cp src dst中的src和dst - 如果误用
flag.String("src", "", "")去接cp src dst的src，会失败 —— 因为没带-src=...或--src ...
自定义类型解析要实现 flag.Value 接口
当需要支持复杂参数（如逗号分隔的字符串列表 --tags=a,b,c、或自定义时间格式 --since=2024-04-01T12:00），不能只靠内置类型。必须定义结构体并实现 flag.Value 接口的两个方法：Set(string) error 和 String() string。
-
Set负责解析输入字符串并存入字段；返回 error 表示解析失败，flag 会中止并打印错误 -
String返回当前值的字符串表示，用于flag.PrintDefaults()显示默认值 - 注册时用
flag.Var(&myVar, "tags", "comma-separated tags")，而非flag.String
漏掉 String() 方法会导致默认值显示为 <nil> 或空，调试时很难判断是否生效。
命令行参数解析看似简单，但 flag 注册时机、位置参数边界、短选项兼容、自定义类型生命周期这几个点，稍不注意就会让工具表现反直觉。尤其在组合多个 flag 或嵌套子命令时，建议尽早加 flag.Usage = func(){...} 自定义帮助输出，比依赖默认行为更可控。
