flag.parse()必须在所有flag定义之后调用，因为flag包采用惰性注册机制，仅当parse()执行时才扫描已注册的flag并赋值，提前调用会导致所有变量保持零值且静默失败。
为什么 flag.Parse() 必须在所有 flag 定义之后调用
因为 flag.Parse() 会扫描全局 flag.FlagSet（默认是 flag.CommandLine）里已注册的 flag，并按命令行实际输入赋值。如果在 flag.String() 等定义前就调用，这些 flag 还没注册，自然不会被识别——结果就是所有参数都为空，且不报错，容易误以为“没输对”。
常见错误现象：./tool -config config.yaml 执行后 configPath 仍是空字符串，flag.PrintDefaults() 也不显示该 flag。
- 必须把所有
flag.String()、flag.Int()、flag.Bool()等定义写在flag.Parse()之前 - 如果用了自定义
flag.FlagSet，也要先定义 flag，再调用其.Parse() -
flag.Parse()会自动处理-h和--help，无需额外判断
如何区分必需参数和可选参数
Go 的 flag 包本身不提供“必填校验”，它只负责解析。是否必需，得靠你手动检查变量值是否为零值（比如 ""、0、false）。
使用场景：比如一个日志分析工具必须指定输入文件路径，但输出格式可选（JSON 或文本）。
- 用
flag.String("input", "", "input file path (required)")定义，然后在flag.Parse()后立即检查：if *input == "" { log.Fatal("error: -input is required") } - 不要依赖默认值伪装“必需”——比如设
flag.String("input", "default.log", ...)，这会让用户误以为可以不传 - 若需多个互斥参数（如
-json和-text），需手动校验：if *json && *text { log.Fatal("error: -json and -text are mutually exclusive") }
如何支持短选项（-v）和长选项（--verbose）共存
Go 的 flag 默认只支持长选项（--xxx）。要支持短选项（-v），必须单独定义一个新 flag，并复用同一变量地址。
性能影响几乎为零，但代码稍显重复；兼容性上，所有 Go 版本（1.0+）都支持这种写法。
- 先声明变量：
var verbose bool - 再分别注册：
flag.BoolVar(&verbose, "v", false, "verbose output")和flag.BoolVar(&verbose, "verbose", false, "verbose output") - 注意：两个 flag 的类型、变量地址、默认值必须一致，否则行为未定义
- 不建议给同一含义的 flag 设置不同默认值（比如一个设
true，一个设false），会导致语义混乱
为什么 flag.Arg(0) 不是第一个自定义参数而是第一个非 flag 参数
flag.Arg(i) 返回的是命令行中跳过所有 flag 及其参数后的剩余部分，也就是“位置参数”（positional arguments）。很多人误以为它是第 i 个 flag 值，其实完全无关。
常见错误现象：运行 ./tool -mode dev deploy service-a，想取 service-a，却写了 flag.Arg(1) 结果 panic（索引越界），因为 flag.Arg(0) 才是 deploy，flag.Arg(1) 是 service-a——但前提是 deploy 没被任何一个 flag 消费掉。
-
flag.Args()返回所有位置参数切片，比反复调用flag.Arg(i)更安全 - 如果某个 flag 带参数（如
-config file.yaml），那么file.yaml属于 flag 值，不会进入flag.Args() - 想严格控制位置参数个数？解析后检查
len(flag.Args())，比如要求至少 1 个：if len(flag.Args())
flag.Parse() 只管语法，不管业务约束。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
