flag包够用但需注意：默认值不生效需显式绑定，子命令须用独立FlagSet隔离，环境变量fallback需手动实现，且顺序为先flag.Parse()再检查环境变量。
Go 新手做命令行配置工具，flag 包够用，但直接上手容易踩坑——比如默认值不生效、子命令没隔离、环境变量没 fallback。别急着抄 cobra，先吃透标准库的边界在哪。
为什么不用 flag 就会漏掉关键配置项
flag 默认只解析 os.Args[1:]，且不自动读取环境变量或配置文件。新手常以为传了 -config=config.yaml 就万事大吉，结果发现 flag.Parse() 后所有自定义字段还是零值。
- 必须显式调用
flag.StringVar(&cfg.File, "config", "", "config file path")才能绑定 - 如果参数名是
config-file（带短横），对应变量名得写成config_file或用flag.CommandLine.Var手动注册 - 未调用
flag.Parse()前，所有flag.XxxVar绑定的变量仍是初始值，不是“未设置”状态
flag 怎么支持环境变量 fallback
标准 flag 不支持，但可以低成本补全：在 flag.Parse() 前，用 os.Getenv() 覆盖空值。
if cfg.Port == 0 {
if port := os.Getenv("APP_PORT"); port != "" {
if p, err := strconv.Atoi(port); err == nil {
cfg.Port = p
}
}
}
- 顺序很重要：先
flag.Parse()，再检查环境变量，否则命令行参数会被覆盖 - 推荐封装成函数，比如
applyEnv(&cfg.Port, "APP_PORT", 8080)，避免重复逻辑 - 注意类型转换失败时的默认兜底，别让
atoipanic 掉整个启动流程
子命令怎么用 flag 而不和主命令冲突
每个子命令要独立的 flag.FlagSet，不能共用 flag.CommandLine，否则 help 会混在一起输出。
var rootCmd = flag.NewFlagSet("root", flag.ContinueOnError)
var serveCmd = flag.NewFlagSet("serve", flag.ContinueOnError)
var rootVerbose = rootCmd.Bool("verbose", false, "enable verbose logging")
var servePort = serveCmd.Int("port", 8080, "server port")
// 解析时先切分参数
if len(os.Args) > 1 {
switch os.Args[1] {
case "serve":
serveCmd.Parse(os.Args[2:])
// ...
default:
rootCmd.Parse(os.Args[1:])
}
}
-
flag.ContinueOnError是关键，否则子命令错参数直接 exit(2) - 子命令的
Parse()必须传入剥离命令名后的参数切片，比如os.Args[2:] - 别忘了给每个
FlagSet单独实现-h/--help输出，flag.PrintDefaults()只对当前 set 生效
真正难的不是解析参数，而是决定哪些该进 flag、哪些该进环境变量、哪些必须写死在代码里。比如数据库密码绝不能出现在 ps aux 可见的命令行中，而监听地址通常需要环境变量 fallback —— 这些约束比语法更重要。
