flag.Var 不能直接传 struct 或 string，因其要求参数实现 flag.Value 接口，而原生类型未实现 Set 和 String 方法；必须用指针接收者定义方法，且 String() 不可返回空字符串。
flag.Var 为什么不能直接传 struct 或 string
因为 flag.Var 要求传入的变量必须实现 flag.Value 接口，而原生 string、struct 或指针类型都不满足。直接传 &myString 会 panic：“flag: invalid value type”。
常见错误现象：flag.Var(&cfg.Tags, "tags", "") 中 cfg.Tags 是 []string 类型，没实现 Set 和 String 方法，运行时报错或静默失效。
- 必须用指针接收者定义方法：
func (s *MyType) Set(string) error，否则赋值不生效 -
String()返回值会被用于 help 输出，不能为空字符串，否则flag.PrintDefaults()可能 panic - 如果类型可能为 nil（如
*time.Location），String()必须先判空
如何用 flag.Var 支持 -tags=a,b,c 和 -tags=x -tags=y 两种写法
标准 flag.StringSlice 只支持空格分隔且无法重复使用同一 flag 名（如多次 -tags），而 flag.Var 配合自定义逻辑可同时兼容逗号分隔和多次出现。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Colly Golang Web Scraper and Crawler Framework
下载
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
- 定义类型
type tagList []string，实现Set(s string) error：对每次调用都做strings.Split(s, ",")并append到接收者 - 在
String()中返回fmt.Sprintf("%v", []string(*t))，避免空 slice 导致 help 显示异常 - 注册时用
flag.Var(&cfg.Tags, "tags", "comma-separated or repeated -tags=xxx") - 注意：命令行中
-tags=a,b,c -tags=x会被解析为["a","b","c","x"]，顺序保留
flag.Var 注册后，flag.Parse() 不生效的典型原因
不是代码写错了，而是 flag 生命周期被破坏了 —— 最常见的是 flag.Parse() 调用时机或 FlagSet 错配。
- 在
init()里调用flag.Parse()：此时os.Args还未初始化，解析永远为空 - 用了自定义
FlagSet（如fs := flag.NewFlagSet("subcmd", flag.ContinueOnError)），却误调全局flag.Parse()，导致注册到fs的flag.Var完全不触发 -
flag.Parse()被调用两次：第二次 panic “flag redefined”，但第一次已执行，可能部分变量被赋值、部分没被处理，状态不一致 - 注册前变量地址已失效：比如在函数内声明局部变量并取其地址传给
flag.Var，该变量随函数返回被回收，后续Set()写入野指针
与 viper/cobra 混用时 flag.Var 的冲突点
flag.Var 默认绑定到全局 flag.CommandLine，而 viper 和 cobra 都会操作这个实例，极易引发重复注册 panic 或 help 信息错乱。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
viper时，禁用其自动绑定：在viper.BindPFlags()前，先调viper.SetFlags(nil)，再手动把每个flag.Var对应的flag.Flag用viper.BindFlagValue()绑定 - 用
cobra时，不要在init()或main()里提前调flag.Var；应在Command.RunE中，用cmd.Flags().Var()替代全局flag.Var - 若必须共存，显式隔离：新建独立
flag.FlagSet，所有flag.Var都注册到它上面，并用该实例的Parse()解析子命令参数
最易被忽略的一点：自定义类型实现的 Set 方法里做了日志或网络请求，而该方法会在 flag.Parse() 期间被多次同步调用 —— 若没考虑并发安全（比如写共享 map），在多 flag 场景下可能 panic 或数据错乱。
