flag.Value接口必须实现Set和String方法，因flag包仅识别二者：Set将字符串转为目标类型，String返回帮助信息中的默认值；缺一或String为空均会panic。
为什么 flag.Value 接口必须实现 Set 和 String 方法
因为 flag 包在解析命令行时，只认这两个方法：Set(string) 负责把字符串转成你的类型，String() 负责在帮助信息里显示默认值。少一个就 panic，常见错误是只写了 Set 忘了 String，或者 String 返回空字符串导致 help 里看不到默认值。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
Set方法里别直接赋值裸 struct，用指针接收者 + 解引用，否则改不了原变量 -
String返回的值会被flag.PrintDefaults()直接打印，建议返回可读格式（比如[]string就用fmt.Sprint） - 如果类型可能为 nil（比如 *time.Location），
String要先判空，否则 panic
自定义类型解析多个值：用 flag.Var 还是 flag.StringSlice
想支持 -tags=a,b,c 或 -tags=a -tags=b 这种多值写法，别硬套 StringSlice —— 它只能处理空格/逗号分隔的单个参数，且不支持重复 flag。真正灵活的方式是自己实现 flag.Value，并在 Set 里做字符串切分或追加。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
flag.Var(&myVar, "tags", "comma-separated list")注册，不是flag.StringSlice -
Set方法里用strings.Split(value, ",")处理逗号分隔，或用append支持多次-tags=xxx - 注意并发安全：如果 flag 在 init 阶段注册，
Set不会并发调用；但如果手动调用flag.Parse()多次，就要加锁
flag 解析失败时不报错？检查 flag.ErrHelp 和 os.Exit(2)
默认情况下，flag.Parse() 遇到未知 flag 或类型错误会直接调用 os.Exit(2) 并打印 usage。你没法捕获错误——这不是 bug，是设计如此。想自己控制错误处理，得提前替换 flag.Usage 和 flag.CommandLine.SetOutput，再手动调用 flag.Parse()。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 想静默失败？用
flag.CommandLine.SetOutput(io.Discard)，但记得自己检查flag.NArg() == 0等逻辑 - 遇到
flag.ErrHelp（比如用户传了-h），它只是个 error 值，不会自动 exit，要你自己判断并退出 - 别在
init()里调用flag.Parse()—— 此时 os.Args 还没准备好，容易拿到空 slice
和 viper / cobra 混用时，flag 包的全局状态会冲突
flag 包默认操作 flag.CommandLine 这个全局变量，而 viper 默认也用它，cobra 则新建自己的 Command 实例。混用时常见问题：help 信息重复、同一个 flag 被注册两次 panic、自定义类型被忽略。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用 viper 时，显式禁用默认 flag：
viper.SetFlags(flag.CommandLine)后再viper.BindPFlags(...)，别让 viper 自己扫 - 用 cobra 时，所有 flag 都通过
cmd.Flags().Var()注册，不要碰flag.CommandLine - 如果必须共存，把自定义类型注册到独立的
flag.FlagSet，再手动 merge 到主 set，避免重复注册
最麻烦的点其实是：自定义类型的 Set 方法里不能依赖尚未解析的其他 flag 值——flag 解析是顺序的，没有依赖解析机制。这点容易被忽略，一用就错。
