go-flags 完全忽略小写结构体字段，因其依赖反射仅遍历导出字段（首字母大写），非导出字段在 runtime 不可见；子命令需导出指针字段且显式标签；parse() 硬退出，parseargs() 可捕获错误。
go-flags 为什么完全忽略小写结构体字段
因为 Go 的反射机制在运行时根本看不到非导出字段。go-flags 依赖 reflect 包遍历结构体字段，而 reflect.ValueOf(&s).Elem().NumField() 返回的只是首字母大写的导出字段数量——小写字段直接被跳过，连类型检查都不会触发。
常见错误现象：type Config struct { port int } 加了 --port 8080 后字段值仍是 0，也不报错、不警告。
- 必须改为
Port int，且建议加标签如`long:"port" short:"p"` - 若想保留小写语义（比如兼容 JSON 字段名），可用嵌入结构体 + 显式标签映射，但字段本身仍需导出
- 环境变量标签
env:"PORT"不会自动转大小写或下划线，env:"API_PORT"只匹配API_PORT环境变量，不是api_port
子命令解析失败时为什么没提示、也没 fallback
go-flags 对子命令的识别是严格路由式的：主结构体中必须声明一个名为 subcommands 的导出字段，类型为 *T（指针），不能是 T 或 interface{}；否则即使字段名拼写正确、结构体定义完整，也会静默忽略。
典型表现：执行 ./cli commit --message "done"，但 commit 结构体字段始终为空，也没有报错输出。
- 主结构体字段必须是
Commit *CmdCommit，不是Commit CmdCommit - 每个子命令结构体也需用导出字段 + 标签，例如
Message string `long:"message" short:"m"` - 未匹配子命令时返回
flags.ErrUnknownCommand，需手动捕获，否则默认行为是打印 Usage 后调用os.Exit(1) - 子命令帮助信息默认不显示，需显式加
`description:"Commit changes to repository"`标签
Parse() 和 ParseArgs() 的错误处理差异很大
parser.Parse() 是“硬退出”模式：遇到 --help、未知 flag、类型转换失败等，都会直接调用 os.Exit()，无法拦截或自定义响应逻辑。这对测试、CLI 嵌入或错误聚合场景极不友好。
而 parser.ParseArgs([]string) 返回 (interface{}, error)，把控制权交还给调用方。
- 错误类型通常是
*flags.Error，其Type字段可区分flags.ErrHelp、flags.ErrUnknownFlag等 - 要打印帮助，应显式调用
parser.WriteHelp(os.Stderr)，而非依赖默认逻辑 - 注意：即使用了
ParseArgs，--help仍会触发os.Exit(0)—— 这是库内部硬编码，必须提前设置parser.UnknownOptionHandler = func() {}并重写 help 处理路径 - 性能影响：无显著差异；但
ParseArgs更利于单元测试断言和 mock
反射解析带来的隐性成本与调试难点
反射本身不慢，但命令行解析器频繁调用 reflect.Value.Field(i)、reflect.Type.Field(i)、tag.Get("long") 等操作，在参数量大或嵌套深时会累积可观开销。更麻烦的是调试体验：字段绑定失败往往没有栈信息，只有最终值不对，你得逆向排查标签拼写、导出状态、指针层级、类型兼容性四个维度。
最容易被忽略的一点：所有反射赋值都要求目标字段可寻址（CanSet() 为 true）。这意味着传入结构体变量时，必须传指针（&config），否则 go-flags 会在内部静默跳过赋值，而不是 panic。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
