flag.Parse()必须在所有flag.Xxx()之后调用，否则后续定义的flag不会被识别；短选项需显式注册；flag.String()返回*string指针，须Parse后解引用；位置参数用flag.Args()获取。
flag.Parse() 必须在所有 flag.Xxx() 之后调用
Go 的 flag 包是惰性注册机制：你调用 flag.String()、flag.Int() 这些函数时，只是把参数定义“登记”进全局 FlagSet，真正解析命令行字符串是在 flag.Parse() 执行时才发生。如果提前调用 flag.Parse()，后续定义的 flag 就完全不会被识别——程序跑起来像没加那个参数一样，还查不出错。
常见错误现象：flag.String("port", "8080", "") 写在 flag.Parse() 后面，结果 -port 3000 传进去，打印出来还是 "8080"；或者直接 panic：「flag provided but not defined」（其实是定义晚了）。
- 所有
flag.Xxx()调用必须放在flag.Parse()之前，通常就在main()开头几行 - 不要在 if 分支里动态注册 flag——比如根据某个环境变量决定是否注册
flag.Bool("debug", false, "")，这会导致逻辑混乱且难以测试 - 如果要用多个独立的 FlagSet（比如子命令），记得用
flag.NewFlagSet()，别混用全局flag和自定义 FlagSet
短选项（-h）和长选项（--help）默认不共存
Go 标准库的 flag 默认只认长选项格式，比如 --help、--port=8080；-h 或 -p 8080 是不支持的，除非你手动注册短名。
使用场景：用户习惯敲 -h 查帮助，但你的程序只响应 --help，体验割裂；或者想同时支持 -c config.yaml 和 --config=config.yaml。
立即学习“go语言免费学习笔记（深入）”；
- 短选项不是自动映射的，
flag.String("config", "", "")不会自动绑定-c - 要支持短选项，得显式调用两次，比如：
flag.String("config", "", "")和flag.String("c", "", "")，再在代码里做逻辑合并（注意：它们是两个独立变量） - 更稳妥的做法是统一用长选项，或用第三方库如
spf13/pflag（兼容 POSIX 短选项，且被 cobra 依赖） - 性能影响几乎为零，但维护成本上升：两个变量指向同一语义，容易漏同步校验逻辑
flag.String() 返回的是 **指针**，不是值
这是最常踩的坑：flag.String("name", "default", "") 返回的是 *string，不是 string。如果你直接赋给一个 string 变量，编译就报错；如果取地址再解引用，又容易在 flag.Parse() 前读值，拿到的是空或默认值。
常见错误现象：写 name := *flag.String("name", "a", "")，结果运行时报 panic：「invalid memory address or nil pointer dereference」——因为 flag.String() 返回的指针在 flag.Parse() 前还没被初始化。
- 正确做法是先声明变量接收指针，再在
flag.Parse()之后解引用：namePtr := flag.String("name", "default", "") flag.Parse() name := *namePtr - 也可以用
var name string; flag.StringVar(&name, "name", "default", "")，避免指针操作，语义更清晰 - 注意：所有
flag.XxxVar()系列函数都要求传入变量地址，类型必须严格匹配，&name不能是&someStruct.Name（除非字段是导出的且类型一致）
非 flag 参数（位置参数）要靠 flag.Args() 拿
flag.Parse() 会把命令行切分成三段：flag 部分、-- 分隔符之后的部分、以及中间剩下的“多余”参数（即位置参数）。很多人以为 os.Args[1:] 还能直接用，结果发现 flag 解析后它已经被截断了。
使用场景：写一个类似 mytool -v copy src dst 的工具，-v 是 flag，copy、src、dst 是位置参数，必须用 flag.Args() 获取。
-
flag.Args()返回的是[]string，内容是flag.Parse()后剩下的所有非 flag 参数 -
flag.Arg(i)是便捷封装，等价于flag.Args()[i]，越界会 panic，不如直接切片安全 - 如果命令行里有
--，它之后的所有内容都会被原样保留在flag.Args()中，包括可能带横杠的字符串（比如-- --force） - 别和
os.Args混用——flag.Parse()修改的是内部状态，os.Args始终是原始数组
命令行参数看似简单，但 flag 的注册时机、指针语义、位置参数边界，这几个点一旦错位，问题往往不报错、只静默失效。实际项目里，建议早一点用 spf13/pflag 替代标准 flag，尤其当你要支持子命令或 POSIX 风格短选项时——不是因为它多强大，而是标准库在这块确实没留太多容错空间。
