flag.Parse()必须在所有flag定义之后调用，否则变量为零值或后续flag失效；推荐将其与flag定义置于main()开头；短长选项需显式注册；优先用flag.StringVar绑定结构体字段；CSV格式参数需自定义flag.Value实现。
flag.Parse() 必须在所有 flag 定义之后调用
不调用 flag.Parse()，所有变量永远是零值；提前调用，后续定义的 flag 全部失效——而且不会报错，只会静默失败。这是最常踩的坑。
- 所有
flag.String()、flag.BoolVar()等注册调用，必须写在flag.Parse()之前 - 推荐把 flag 定义和
flag.Parse()放在main()开头，中间不穿插其他逻辑（比如日志初始化、配置加载） - 如果需要在解析前检查是否传了
-h，别直接用flag.Parse()，改用flag.CommandLine = flag.NewFlagSet(os.Args[0], flag.ContinueOnError)手动控制
短选项（-v）和长选项（--verbose）不能共用同一个变量
Go 标准库 flag 不支持别名自动映射。写 flag.Bool("v", false, "") 和 flag.Bool("verbose", false, "") 是两个独立 flag，用户同时传 -v --verbose 会触发两次赋值，最终以后者为准，但语义已错乱。
- 高频短选项（如
-h、-v）可以保留，但必须显式注册：用flag.BoolVar(&help, "h", false, "show help")和flag.BoolVar(&help, "help", false, "") - 业务逻辑里统一判断：
if *help || *h { printUsage(); os.Exit(0) } - 别指望
-h自动触发--help的 help 输出——flag.Usage默认只响应未识别 flag，需手动拦截
想绑定字符串到结构体字段？优先用 flag.StringVar
flag.String() 返回 *string，要解引用；flag.StringVar() 直接写入已有变量地址，更安全、更易测试，尤其适合配置 struct。
- 结构体字段必须已声明，且生命周期覆盖到
flag.Parse()之后，例如：var cfg struct{ Host string }; flag.StringVar(&cfg.Host, "host", "localhost", "") - 传参必须是指针：
flag.StringVar(cfg.Host, ...)会编译失败，正确写法是&cfg.Host - 脚本类一次性工具可用
flag.String()，但指针管理容易出错，不推荐混用
解析逗号分隔字符串（如 --tags=a,b,c）必须实现 flag.Value
flag.StringSlice 只支持空格或引号分隔，对 --tags=a,b,c 这种 CSV 格式无效。原生 flag 不处理语法糖，得自己实现 flag.Value 接口。
立即学习“go语言免费学习笔记（深入）”；
- 核心是两个方法：
Set(string) error和String() string -
Set里要处理空字符串、空白字符，建议用strings.Split(strings.TrimSpace(value), ",")并过滤空项 - 多次传参（如
--tag a --tag b）需在Set中用append累积，而不是直接赋值
真正麻烦的不是写 Set 方法，而是忘记在 Set 里返回错误——比如 time.ParseDuration 失败却没 return error，flag 就会静默跳过该参数，很难排查。
