go-flags仅解析首字母大写的导出字段，小写字段因go反射限制不可见；子命令需用subcommands字段声明导出指针类型；错误处理应改用parseargs避免硬退出；环境变量需显式启用env:标签且优先级低于命令行参数。
go-flags 解析结构体字段时为什么忽略小写字段
因为 go-flags 只处理导出（首字母大写）的结构体字段，这是 Go 的反射机制限制，非导出字段在运行时不可见。
常见错误现象：定义了 type Config struct { port int } ，但 --port 8080 完全不生效，也没有报错。
- 必须改为
Port int，并可选加`long:"port" env:"PORT"`标签 - 如果想保留小写字段名又需解析，只能用嵌入结构体 + 显式标签映射，例如：
Port int `long:"port" short:"p"` - 注意
env:标签不会自动转下划线，env:"API_PORT"对应环境变量API_PORT，不是api_port
如何让 go-flags 支持子命令（如 git commit / git push）
用 subcommands 字段声明嵌套结构体，每个子命令对应一个导出字段，类型为指针（*CmdCommit），go-flags 会自动识别并路由。
使用场景：CLI 工具需要分功能模块，避免所有参数挤在一个结构体里。
- 主结构体字段类型必须是
*T，不能是T或interface{} - 子命令结构体也需用导出字段 + 标签，例如
Message string `long:"message" short:"m"` - 调用
parser.Parse()后，未匹配子命令时会返回flags.ErrUnknownCommand，需手动捕获处理 - 子命令帮助信息默认不显示，需对每个子命令结构体添加
`description:"..."`标签
解析失败时为什么只打印 Usage 就退出，无法自定义错误处理
默认行为由 parser.CommandLineParser.Parse() 内部调用 os.Exit(1) 导致，它不返回错误而是直接终止进程。
性能 / 兼容性影响：在测试或嵌入式 CLI 场景中，硬退出会导致难以 mock 和断言。
- 改用
parser.ParseArgs([]string)，它返回(interface{}, error)，错误类型可能是*flags.Error -
*flags.Error有Type字段，值为flags.ErrHelp、flags.ErrUnknownFlag等，可用于分流处理 - 若仍需打印 Usage，调用
parser.WriteHelp(os.Stderr)，而非依赖默认逻辑 - 注意：即使用了
ParseArgs，--help仍会触发os.Exit(0)—— 这是库的硬编码行为，必须提前设置parser.UnknownOptionHandler = func(...) {}并重写 help 处理
如何让 go-flags 自动从环境变量回退读取参数值
靠字段标签里的 env: 指令，但默认不启用，必须显式开启环境变量支持。
容易踩的坑：开了 env: 却没调用 parser.Parse() 的变体，或混淆了优先级顺序。
- 初始化 parser 时传入
flags.Default &^ flags.IgnoreEnv，否则env:标签被忽略 - 值优先级固定为：命令行参数 > 环境变量 > 结构体零值（无默认）
- 环境变量名默认是全大写 + 下划线，由字段名自动转换（
ApiUrl→API_URL），但可通过env:"CUSTOM_NAME"覆盖 - 布尔字段的环境变量只认
"1"、"true"、"TRUE"等，不识别空字符串或未设置 —— 这点和命令行--flag的存在即 true 不同
os.Args，再解析，避免被 shell 层面的引号或空格干扰判断。
