不能直接用 flag.stringslice，因为它硬编码逗号分割、破坏含空格字符串（如"prod env"被拆成["prod","env"]），且无法区分--tag a --tag b与--tag a,b；正确做法是自定义实现flag.value接口的stringlist类型，每次set直接追加完整字符串。
为什么不能直接用 flag.StringSlice？
因为 flag.StringSlice 默认以逗号分隔，且不支持带空格的字符串（比如 --tag "prod env" --tag "v2.1"），而真实 CLI 场景中用户更倾向用多次重复 flag 传入含空格的值。此时 StringSlice 会把 "prod env" 拆成 ["prod", "env"]，完全错误。
根本原因在于：它实现的是 flag.Value 接口，但内部逻辑硬编码了逗号分割，不可定制。
- 你无法控制分隔行为 —— 它只认
, - 你无法保留引号内的空格 —— shell 已传入完整字符串，但
StringSlice在 Set 中擅自切分 - 它不区分
--tag a --tag b和--tag a,b，语义混同
如何正确实现 flag.Value 支持多值 + 空格保留
核心是自己写一个类型，实现 Set(string)、String() 和 Get() 三个方法。关键点：每次调用 Set 就追加一个完整字符串，不做任何拆分。
示例实现：
type StringList []string
func (s *StringList) Set(v string) error {
*s = append(*s, v)
return nil
}
func (s *StringList) String() string {
return strings.Join([]string(*s), ", ")
}
func (s *StringList) Get() interface{} {
return []string(*s)
}
使用方式：
var tags StringList
flag.Var(&tags, "tag", "add tag (can be repeated)")
flag.Parse()
// 输入: -tag "db migration" -tag "v3"
// tags == []string{"db migration", "v3"}
- 必须传指针
&tags给flag.Var，否则Set修改不了原值 -
String()只用于-h输出展示，不影响解析逻辑 - 如果需要类型安全，可封装为
type TagList []string并实现同名方法
与 pflag（Cobra）共存时要注意什么
如果你用的是 spf13/pflag（比如 Cobra），它不兼容标准库 flag.Var 的注册方式，直接调用会 panic：flag provided but not defined: -tag。
必须改用 pflag 自己的 VarP 或 Var 方法：
var tags StringList rootCmd.Flags().Var(&tags, "tag", "add tag (repeated)") // 或带短选项： // rootCmd.Flags().VarP(&tags, "tag", "t", "add tag")
-
pflag.FlagSet不识别flag.Var注册的变量，哪怕你 import 了flag -
pflag的Var要求目标类型有String()和Set(string) error，和标准库一致，所以你的StringList可复用 - 不要混用：同一 flag 名不能既用
flag.StringSlice又用自定义Var，会冲突
进阶：支持从环境变量或配置文件自动注入
单纯命令行还不够，很多工具需同时支持 ENV=prod,stage 或 YAML 中 tags: ["a", "b"]。这时不能只依赖 flag.Value，得配合外部解析逻辑。
建议做法：保留 StringList 类型，但不在 flag.Var 中直接绑定；改为手动收集原始参数，再统一合并来源：
// 先用 string slice 接收所有原始值（避免提前拆分）
var rawTags []string
flag.StringSliceVar(&rawTags, "tag", nil, "...")
// 解析后，再按需处理每个 rawTags[i] —— 此时仍是完整字符串
for _, t := range rawTags {
tags = append(tags, t) // 直接追加，不 split
}
- 这种写法绕过了
flag.Value的限制，更灵活 - 便于后续插入 trim、去重、校验等逻辑
- 环境变量可走
os.Getenv("TAGS")，再strings.FieldsFunc(..., func(r rune) bool { return r == ',' })分割（注意：仅当环境变量明确用逗号分隔时才这么干）
真正容易被忽略的是：不同来源的优先级顺序（CLI > ENV > config file）必须显式控制，且空字符串、重复值、前后空格这些边界情况，flag.Value 实现里往往没做清洗 —— 这部分得你自己补。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
