必须实现 flag.Value 接口的 Set 和 String 方法，因 flag 包仅依赖二者：Set 负责解析字符串并返回错误，String 负责在 help 中显示默认值；缺一将导致 panic 或静默失败。
必须实现 flag.Value 接口，缺 Set 或 String 任一方法都会 panic。
为什么自定义类型必须实现 Set 和 String 方法
Go 的 flag 包不靠类型推导，只认这两个方法：Set(string) error 负责把命令行字符串转成你的目标值，String() string 负责在 flag.PrintDefaults() 里显示默认值。漏掉 String（比如返回空字符串或直接 return）会导致 help 信息里看不到默认值；Set 里 panic 而不是返回 error，会让解析失败静默吞掉——用户输错参数却没提示。
常见错误：
- 只写了
Set，忘了String，运行时 panic -
String方法里对 nil 指针直接调用（比如*time.Location未初始化就.String()） -
Set返回nil错误但逻辑实际出错（应返回明确的errors.New("xxx")）
如何正确实现一个枚举型 flag（如 --origin installed）
比用 flag.String 更安全：限制输入只能是预设值，非法输入直接报错退出。
立即学习“go语言免费学习笔记（深入）”；
关键点：
- 定义一个命名类型（如
type Origin string），不是直接用string -
Set方法内做白名单校验，匹配失败返回error -
String返回一个可读的默认值（如"installed"），不是空字符串 - 用
flag.Var(&v, "origin", "origin of version info")注册，不是flag.String
示例片段：
type Origin string
const (
OriginInstalled Origin = "installed"
OriginLocal Origin = "local"
OriginRemote Origin = "remote"
)
func (o *Origin) Set(s string) error {
switch Origin(s) {
case OriginInstalled, OriginLocal, OriginRemote:
*o = Origin(s)
return nil
default:
return fmt.Errorf("invalid origin: %q, want %q, %q, or %q", s, OriginInstalled, OriginLocal, OriginRemote)
}
}
func (o Origin) String() string {
return string(o)
}
// 使用：
var origin Origin
flag.Var(&origin, "origin", fmt.Sprintf("origin of version info (%s)", strings.Join([]string{string(OriginInstalled), string(OriginLocal), string(OriginRemote)}, "|")))
支持多值参数（如 --tag a --tag b 或 --tags a,b,c）
flag.StringSlice 看似能用，但它只支持单个参数内逗号/空格分隔（--tags a,b,c），不支持重复 flag（--tag a --tag b）。真要两者都兼容，得自己实现 flag.Value。
实操要点：
-
Set方法里判断是否已存在值：若支持追加，就用append；若只接受逗号分隔，就用strings.Split(s, ",") - 内部存储用切片（如
[]string），String返回fmt.Sprint(v)保证 help 可读 - 别在
Set里修改传入的原始s字符串（如strings.TrimSpace后直接赋值），要复制再处理 - 注册仍用
flag.Var(&myTags, "tag", "add tag")，注意 flag 名用单数更符合 CLI 习惯
和 viper 或 cobra 混用时 flag 全局状态冲突
flag.CommandLine 是全局变量，viper 默认绑定它，cobra 则新建独立 Command 实例。混用会触发注册两次 panic、help 重复打印、自定义类型被忽略。
避坑方式：
- 用
viper时，显式禁用其默认 flag 绑定：viper.SetFlags(flag.CommandLine)，之后再viper.BindPFlags(...) - 用
cobra时，别再手动调用flag.String等全局注册函数；所有 flag 应通过cmd.Flags().String添加 - 绝对不要在
init()里调用flag.Parse()—— 此时os.Args还未稳定，可能为空
最易被忽略的一点：自定义 flag.Value 类型如果带指针字段（如 *time.Location），String() 必须先判空，否则 help 打印时直接 panic。这个错误不会在解析阶段暴露，只会在用户执行 -h 时崩掉。
