flag.Parse()必须在所有flag.Xxx()之后调用，否则参数不生效；推荐用flag.StringVar而非flag.String；-h和--help需分别注册；必需参数需手动校验。

flag.Parse() 必须在所有 flag.Xxx() 之后调用

参数不生效、始终是默认值、甚至 panic: “flag provided but not defined”，八成是因为 flag.Parse() 被提前执行了。Go 的 flag 包不是“声明即生效”，而是先注册（flag.String、flag.IntVar 等调用），再统一解析（flag.Parse()）——它只处理调用前已注册的 flag。

• 所有 flag.String、flag.BoolVar 等必须写在 flag.Parse() 之前，通常集中在 main() 开头几行
• 不要在 if 分支里动态注册 flag，测试和维护都困难
• 别在 init() 或函数开头就调 flag.Parse()；更别把它和 flag 定义穿插着写

用 flag.StringVar 还是 flag.String？

flag.String 返回 *string，你得自己管理指针、记得解引用、还得确保在 flag.Parse() 后读值；flag.StringVar 直接写入你声明好的变量，无指针负担，也更易调试和复用。

• 结构体字段、配置 struct 初始化、需要复用变量名的场景，必须用 flag.StringVar
• 新手误写 if name == "admin"（而 name 是 *string），编译直接报错：invalid operation: == (mismatched types string and *string)
• flag.String 每次调用都新分配内存；flag.StringVar 不额外分配，性能和安全都更优

如何让 -h 和 --help 都生效且不退出

flag 默认只认 --help，-h 是未知 flag，会触发默认错误输出并直接退出——这对 CLI 工具很不友好。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

• 必须显式注册两个名字，指向同一个变量：flag.BoolVar(&help, "h", false, "show help") 和 flag.BoolVar(&help, "help", false, "")
• flag.Parse() 后立刻检查：if help { flag.Usage(); os.Exit(0) }
• 用 flag.CommandLine.SetOutput(io.Discard) 抑制默认错误输出，再自行处理 flag.ErrHelp 或其他错误

必需参数怎么校验？

flag 本身没有 “required” 概念，所有 flag 都是可选的。是否必需，完全由你解析后判断。

立即学习“go语言免费学习笔记（深入）”；

• 定义时别设误导性默认值（比如 "-" 表示 stdin），用户真传 - 当文件名就冲突了
• flag.Parse() 后检查零值：if *inputFile == "" { fmt.Fprintln(os.Stderr, "error: -input is required"); os.Exit(1) }
• 若需强约束（如自动报错、文档标记 required），建议换 spf13/pflag 或 alecthomas/kingpin

真正麻烦的不是写几个 flag.String，而是短选项和长选项语义一致、错误提示不甩锅给用户、帮助信息能一眼看懂——这些 flag 包都不管，全得你手动补全。