flag.parse()必须在所有flag.xxx()之后、首次读取前执行，因其采用惰性注册+延迟解析机制：flag.xxx()仅登记参数到全局commandline，真正解析仅发生在flag.parse()时且只处理此前已注册的flag。
flag.Parse() 必须在所有 flag.Xxx() 调用之后、任何变量读取之前执行，否则所有 flag 值都维持零值——这不是 bug，是 flag 包的注册-解析分离设计决定的。
为什么 flag.Parse() 放错位置会导致参数“不生效”
Go 的 flag 包不是边定义边解析，而是先批量注册（flag.String 等只是往全局 FlagSet 里登记），再统一扫描 os.Args。如果 flag.Parse() 写在某个 flag.String("port", "8080", "") 之前，那这个 port 根本没被注册，用户传了 -port 3000 也会报错 "flag provided but not defined"；如果写在之后但又提前用了 *port，拿到的还是初始空字符串或默认值，误以为解析成功。
-
flag.Parse()必须紧接在全部flag.Xxx()调用之后，通常就在main()开头几行 - 不要在
if分支里动态调用flag.String()，会导致部分环境无法注册、测试难覆盖 - 若需条件式注册（比如仅开发环境加
-debug），应改用flag.NewFlagSet()隔离，避免污染全局
flag.String 和 flag.StringVar 怎么选
区别不只是“返回指针”和“填变量”：前者返回 *string，后者接收 *string 地址并直接写入。这直接影响作用域、初始化时机和测试方式。
- 用
flag.String()时，必须解引用才能取值：fmt.Println(*myPort)；若在flag.Parse()前读，会 panic 或得零值 - 用
flag.StringVar(&cfg.Port, "port", "8080", "")时，cfg.Port必须已声明且生命周期覆盖到flag.Parse()后，适合绑定结构体字段 - 单元测试中，
flag.StringVar更易 mock：传个局部变量地址进去，断言赋值即可；flag.String需要额外清理全局 FlagSet
如何支持 -t 30s 或 -tags a,b,c 这类复杂参数
原生 flag 只支持基础类型（string、int、time.Duration 等）。像重复 flag（-v -v -v）、逗号分隔列表、带单位的时间字符串，必须实现 flag.Value 接口。
-
time.Duration已内置支持，直接用flag.Duration("timeout", 30*time.Second, "")即可解析-timeout 2m - 要支持
-tags foo,bar,baz，需定义结构体并实现Set(string) error和String() string方法 - 重复 flag（如多次
-include）不能靠flag.StringSlice自动合并，得自己在Set里 append 到切片 - 别忘了在
Set方法里做输入校验，比如拒绝空 tag、非法 duration 字符串，否则错误会静默吞掉
短选项（-h）为什么默认不工作
flag 包默认只识别长格式（--help），-h 不是自动映射的别名。它不兼容 POSIX 短选项约定，这是标准库有意为之的简化设计。
- 显式注册短名：同时调用
flag.Bool("help", false, "")和flag.Bool("h", false, "")，再手动合并逻辑（比如任一为 true 就打印帮助） - 更推荐换用
spf13/pflag：它完全兼容flagAPI，且原生支持-h↔--help映射，cobra底层就依赖它 - 混用
flag和pflag会出问题：全局flag.Parse()不会触发pflag注册的 flag，必须统一入口
flag.Value 实现容易漏写 String() 方法，导致 -h 输出里显示 `Set() 写成只覆盖不追加，结果重复 flag 只生效最后一次。这些细节不报错，但行为和预期差很远。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
