go flag包原生不支持子命令，需用flag.newflagset为每个子命令创建独立实例；主程序仅解析命令名，子命令函数接收剩余参数并自行解析，避免全局flag冲突与重复注册panic。
Go flag 包原生不支持子命令，硬套会踩坑
直接用 flag 解析 git commit -m "xxx" 这种结构会失败——flag.Parse() 遇到第一个非 flag 参数（比如 commit）就停了，后面的 -m 根本不会被识别。这不是你参数写错了，是 flag 的设计逻辑决定的：它只处理「单命令 + 全局 flag」这一层，没预留子命令分发入口。
常见错误现象：
- ./tool deploy --env=prod --dry-run 能跑，但 ./tool deploy apply --env=prod 报 flag provided but not defined: -env
- 手动切 os.Args 后再调两次 flag.Parse()，结果第二次解析崩溃（flag redefined）
原因很简单：flag.CommandLine 是全局单例，重复注册同名 flag 就 panic。别试图“重置”它，Go 标准库没留这个口。
用 flag.NewFlagSet 手动构造子命令上下文
核心思路：每个子命令（如 deploy、apply）配一个独立的 *flag.FlagSet 实例，各自管理自己的 flag，互不干扰。
- 主程序只用
flag解析最外层命令名（os.Args[1]），不调flag.Parse() - 根据命令名匹配到对应子命令函数，把
os.Args[2:]传进去 - 子命令函数里新建
flag.NewFlagSet(cmdName, flag.ContinueOnError)，再注册自己的 flag - 显式调用
fs.Parse(args)，检查返回 error 决定是否退出
示例片段：
立即学习“go语言免费学习笔记（深入）”；
func runDeploy(args []string) {
fs := flag.NewFlagSet("deploy", flag.ContinueOnError)
env := fs.String("env", "dev", "target environment")
dryRun := fs.Bool("dry-run", false, "skip actual execution")
<pre class='brush:php;toolbar:false;'>if err := fs.Parse(args); err != nil {
os.Exit(2)
}
fmt.Printf("deploy to %s, dry-run=%t\n", *env, *dryRun)}
子命令 flag 名称冲突时得加前缀或换名
多个子命令都用 --timeout？flag.NewFlagSet 确实允许重名，但用户输入时容易混淆：比如 tool backup --timeout=30 restore --timeout=60，实际只有第一个 --timeout 被解析（因为 os.Args 是扁平数组，没天然边界）。
所以必须约定输入格式：
- 正确：tool backup --timeout=30 和 tool restore --timeout=60（分开调用）
- 错误：tool backup restore --timeout=60（这已经不是子命令，是 backup 的位置参数）
如果你真需要链式操作（类似 git add -A && git commit -m），那就不是 flag 能解决的，得自己 parse token 流或换用 spf13/cobra。
性能影响几乎为零——flag.NewFlagSet 只是结构体初始化，没 IO 或反射开销；兼容性也稳，从 Go 1.0 到 1.22 都没变过接口。
错误处理和 Usage 提示得手动接管
flag 默认的 Usage 输出只针对 flag.CommandLine，你用 flag.NewFlagSet 后，fs.PrintDefaults() 不会自动关联命令名，也不会输出子命令层级帮助。
- 调用
fs.SetOutput(os.Stdout)控制输出目标 - 在 parse 失败时，别只打印 error，要补上
fmt.Fprintf(fs.Output(), "Usage: %s %s [flags]\n", os.Args[0], fs.Name()) - 如果想支持
tool deploy -h，就在子命令 flag 里加一个helpbool，并在 parse 后检查：若*help为 true，就调fs.PrintDefaults()然后 exit(0)
容易被忽略的一点：子命令的 flag.Usage 函数不会被自动调用，你得在 fs.Parse() 返回 flag.ErrHelp 时手动触发提示——否则 -h 什么也不输出，用户以为功能没做。
事情说清了就结束
