go原生flag包不支持嵌套子命令，因其将所有flag平铺处理；pflag通过独立flagset实现子命令解析，但需手动管理命令树，且flag作用域、环境变量联动等需显式控制。
为什么不能直接用 flag 包处理嵌套子命令？
Go 原生 flag 包不支持子命令分组和层级解析——它把所有 flag 当作平铺参数处理，cmd subcmd -v 会被当成主命令的 flag，subcmd 自身无法拥有独立 flag 集合。一旦项目需要类似 git commit -m "xxx" 或 docker build --platform linux/amd64 . 这种结构，原生 flag 就力不从心了。
而 pflag（即 spf13/pflag）是 flag 的增强替代，它原生支持子命令、短长 flag 混用、类型自动转换，且与 cobra 深度耦合。但注意：pflag 本身不提供命令树管理，它只管“解析”，真正组织层级靠的是手动或借助 cobra。
用 pflag 手动实现两级子命令（无 cobra）
如果你不想引入 cobra（比如轻量 CLI 工具、已有主逻辑不愿重构），可以手动维护命令树 + pflag.FlagSet 实例。关键点是：每个子命令需独占一个 pflag.FlagSet，避免 flag 冲突和覆盖。
-
rootCmd := pflag.NewFlagSet(os.Args[0], pflag.ContinueOnError)—— 主命令 flag 集 -
buildCmd := pflag.NewFlagSet("build", pflag.ContinueOnError)—— 子命令 flag 集，名称仅作标识，不参与解析 - 调用前必须先
buildCmd.Parse(os.Args[2:])，跳过os.Args[0]（程序名）和os.Args[1]（子命令名） - 务必检查
len(os.Args) > 1，否则os.Args[1]会 panic
示例片段：
// 解析子命令名
if len(os.Args)
<h3>
<code>pflag</code> 与 <code>cobra</code> 集成时 flag 作用域容易错乱</h3>
<p>很多人以为 <code>cobra.Command.Flags()</code> 和 <code>cobra.Command.PersistentFlags()</code> 是互斥的，其实不是：PersistentFlags 会向下继承到所有子命令，而 Flags 只属于当前命令。如果在父命令上误用 <code>Flags().StringP("config", "c", "", "")</code>，子命令就无法定义自己的 <code>-c</code>；但若用 <code>PersistentFlags()</code>，又会导致所有子命令都强制接受该 flag。</p>
- 通用 flag（如
--verbose）放PersistentFlags()，并在Run中通过cmd.Flags().GetBool("verbose")读取 - 子命令专属 flag（如
build --platform）必须在对应子命令的Flags()上注册，不能在 root 或 parent 上注册 - 避免在多个命令中重复调用
cmd.Flags().String(...)同名 flag，pflag 不报错但行为未定义（实际以最后注册为准）
常见错误现象：myapp build --help 显示了不该出现的 flag，或 --config 在子命令里无法被识别——基本都是 flag 注册位置错了。
多层级 flag 默认值和环境变量联动要手动桥接
pflag 支持 .Lookup("name").Value.Set("val") 设默认值，也支持 .EnvVar("MYAPP_TIMEOUT") 绑定环境变量，但它**不会自动把环境变量值当作默认值 fallback**。也就是说，如果用户既没传 --timeout，也没设 MYAPP_TIMEOUT，你得自己判断并填充。
- 推荐模式：先调用
cmd.Flags().Parse()，再遍历所有 flag，对未变更（Changed == false）且有EnvVar设置的 flag，手动从os.Getenv()赋值 -
pflag不解析环境变量大小写，EnvVar("APP_TIMEOUT")对应os.Getenv("APP_TIMEOUT")，不会尝试app_timeout或AppTimeout - 如果用了
cobra，可利用其BindPFlags+viper自动桥接，但那是另一层抽象，不在纯pflag范畴内
真正复杂的不是语法，是 flag 生效顺序：命令行参数 > 环境变量 > 代码默认值。这个顺序必须由你显式控制，pflag 只负责前半段。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
