flag.parse() 必须在所有 flag.xxx() 调用之后、首次读取参数值之前执行，否则因惰性注册机制导致未注册的 flag 不被解析，变量保持零值或默认值。
flag.Parse() 必须在所有 flag.Xxx() 调用之后、首次读取参数值之前执行，否则变量永远拿不到用户输入，只保留零值或默认值。
为什么 flag.Parse() 放错位置就拿不到参数？
Go 的 flag 包是惰性注册 + 延迟解析机制：flag.String()、flag.IntVar() 等函数只是把参数定义“登记”进全局 flag.CommandLine，并不读取 os.Args；真正解析动作只发生在 flag.Parse() 执行时，且它只处理此前已注册的 flag。
- 常见错误现象：
flag.String("port", "8080", "")写在flag.Parse()后面，传入-port 3000，打印*port仍是"8080" - 更隐蔽的问题：
flag.Parse()放在init()函数里，而flag.String()在main()开头——此时main()中的定义根本没被注册，flag.Parse()已执行完毕 - 正确顺序只有一条：所有
flag.Xxx()→ 单次flag.Parse()→ 后续使用变量（解引用或直接访问）
flag.String() 和 flag.StringVar() 怎么选？
两者功能等价，但内存模型和可维护性差异显著。
-
flag.String()返回*string，你必须记住解引用（*name），且该指针在flag.Parse()前为nil，提前解引用会 panic -
flag.StringVar()直接绑定已有变量地址，规避指针生命周期管理；结构体字段初始化推荐用flag.StringVar(&cfg.Port, "port", "8080", "")，后续直接用cfg.Port - 测试友好：
var testPort string; flag.StringVar(&testPort, "port", "", "")可在单元测试中快速 mock - 避免编译错误：
flag.StringVar(cfg.Port, )会报错cannot use cfg.Port (type string) as type *string，强制你传地址，提早暴露问题
短选项（-h）和长选项（--help）怎么同时支持？
标准库 flag 不支持 POSIX 风格的短选项自动绑定，-h 和 --help 是两个完全独立的 flag 名称，必须分别注册并手动同步逻辑。
- 不能只写
flag.Bool("help", false, "")就指望-h生效；必须显式注册：flag.BoolVar(&help, "h", false, "show help")和flag.BoolVar(&help, "help", false, "show help") - 别依赖
flag自动退出：注册后需主动检查if help { flag.Usage(); os.Exit(0) }，否则-h会被当作未知 flag 导致 panic - 若需统一处理，建议在
flag.Parse()后合并判断：if *h || *help { ... }，注意两个变量都得声明并注册
解析切片、CSV 或重复参数时要注意什么？
内置 flag.StringSlice() 等不支持自动累积多个同名 flag（如 -tag a -tag b），也不支持逗号分隔格式（如 -tags=a,b,c）——这些必须实现 flag.Value 接口。
- 核心是实现两个方法：
Set(string) error控制每次解析时如何更新内部状态；String() string用于 help 输出和日志打印 - 容易漏掉空字符串处理：比如
-tags=a,,b会生成[]string{"a", "", "b"}，应在Set里加strings.TrimSpace和过滤空项 - 若需支持多次传参（如多个
-file），Set方法里要用append，而不是直接赋值 -
flag.DurationVar就是这么实现的，可参考其源码
最常被忽略的是：flag.Parse() 的调用时机和 flag.Value 的错误处理逻辑——前者出错无声无息（变量永远是零值），后者出错则静默丢弃参数，连 warning 都没有。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
