标准 flag 包不支持 --flag=value 语法、短长选项共存、复杂类型及子命令隔离；pflag.stringslicevar 需传指针，支持 --path=a --path=b 和 --path=a,b；子命令靠独立 flagset 实现隔离；errhelp 必须显式处理并 os.exit(0)。
为什么不能直接用标准 flag 包
标准 flag 包不支持 POSIX/GNU 风格的 --flag=value 语法（比如 --port=8080），也不支持短选项与长选项共存（如 -c config.yaml 和 --config=config.yaml 同时生效）。它对切片、映射、IP 地址等复杂类型支持极弱，更没有内置子命令隔离能力。一旦项目需要支持 git commit -m "xxx" 这类多级命令结构，flag 就会迅速失控。
pflag.StringSliceVar 处理多个字符串值
当用户要传入多个路径、标签或配置项时，StringSliceVar 是最常用也最容易出错的接口之一。
- 必须用指针传入变量：
var paths []string→fs.StringSliceVar(&paths, "path", nil, "input paths")，漏掉&会导致值无法写入 - 支持两种输入方式：
--path=a --path=b或--path=a,b，但后者依赖 pflag 默认的逗号分隔逻辑；若需其他分隔符（如分号），得自己实现Value接口 - 空切片作为默认值（
nil）会被自动转为空切片[]string{}，但若设为[]string{"default"}，用户不传参时仍会得到该默认值 - 调用
fs.Parse(os.Args[1:])后才能读取paths，提前访问是空的
FlagSet 实现子命令隔离的关键操作
子命令（如 mytool serve 和 mytool build）不是靠 if 判断字符串实现的，而是靠独立的 FlagSet 实例隔离参数空间。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 每个子命令对应一个
FlagSet：serveCmd := pflag.NewFlagSet("serve", pflag.ContinueOnError) - 主命令解析后，检查第一个非 flag 参数是否为子命令名：
if len(flag.Args()) > 0 && flag.Arg(0) == "serve" - 子命令的
Parse必须传入剩余参数：serveCmd.Parse(flag.Args()[1:])，否则会把子命令名误认为参数 - 不同子命令可定义同名 flag（如都叫
--timeout），互不干扰，因为它们属于不同FlagSet
ErrHelp 错误必须显式处理
pflag.ErrHelp 不是普通错误，它是用户主动请求帮助时触发的控制流信号，不处理就会导致程序退出码为 2，且 help 文本重复输出两次。
- 必须在
Parse()后立即判断：if err == pflag.ErrHelp - 此时应直接
os.Exit(0)，而不是继续执行业务逻辑 - 不要用
log.Fatal或 panic 捕获它——那会让 help 看起来像崩溃 - 如果用了自定义
UsageFunc，也要确保它在ErrHelp触发前已注册，否则 help 格式会回退到默认
真正容易被忽略的是：FlagSet 的命名只影响 help 输出和错误提示，不参与解析逻辑；而 ContinueOnError 模式下，即使某个 flag 解析失败（比如 --port=abc），后续 flag 仍会继续尝试解析——这在调试阶段可能掩盖真实问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
