Go 标准库的 flag 包是编写命令行工具时最常用的参数解析方案，它简单、零依赖、行为稳定。但用久了就会发现两个明显的短板：第一，flag 包没有内置的必填参数机制，用户漏传参数时程序照样往下跑，直到半路才报一个莫名其妙的错误；第二，flag 包只认单横线开头的参数，不管是 -addr 还是 --addr 都会被解析成同一个名字，想做出像 -v 和 --verbose 共存的效果，原生 flag 就无能为力了。这篇文章就来解决这两个问题，给出几种可以直接落地的方案。
先搞清楚 flag 包的默认行为
在动手改造之前，需要先理解 flag 包的解析规则。看下面这段最常见的代码：
package main
import (
"flag"
"fmt"
)
func main() {
addr := flag.String("addr", "127.0.0.1:8080", "服务监听地址")
name := flag.String("name", "", "服务名称")
flag.Parse()
fmt.Println(addr, name)
}这段代码里 flag.String("name", "", ...) 的默认值是空字符串。如果用户没有传 -name，flag 包不会报任何错，name 就安静地保持空值。程序带着一个空字符串继续执行，往往到写日志或者注册服务的时候才暴露问题，排查起来相当费劲。
另一个容易被忽略的细节是，flag 包对参数前缀非常宽容。用户输入 -addr 和 --addr 效果完全一样，flag 包内部会把开头的连续横线统统去掉。这看起来是好事，但意味着你没有办法区分 -n 和 --name，因为它们会被当成同一个参数名 n 或者 name。想要类似 POSIX 风格的短参数，原生 flag 做不到。
还有一个坑：如果用户传了一个未定义的参数，比如 -port，flag 包默认会打印错误信息并以状态码 2 退出，这个行为倒还算友好。但必填校验就必须自己动手了，下面进入正题。
方案一：手动校验实现必填参数
最直接的办法是在 flag.Parse() 之后逐个检查必填项，为空就打印用法说明并退出。这种写法不引入任何额外依赖，代码逻辑一目了然，适合参数数量不多的中小型工具。
package main
import (
"flag"
"fmt"
"os"
)
func main() {
name := flag.String("name", "", "服务名称（必填）")
token := flag.String("token", "", "访问令牌（必填）")
flag.Parse()
if *name == "" {
fmt.Fprintln(os.Stderr, "错误：必须提供 -name 参数")
flag.Usage()
os.Exit(1)
}
if *token == "" {
fmt.Fprintln(os.Stderr, "错误：必须提供 -token 参数")
flag.Usage()
os.Exit(1)
}
fmt.Println("启动服务：", *name)
}这种方式的优点是零依赖、可控性强，错误提示想写多详细都可以。缺点也很明显：每加一个必填参数就要多写一段 if 判断，参数多了以后 main 函数会被校验逻辑塞满，维护体验下降。另外，如果某个参数的合法值本身就是空字符串，这种判空方式就失效了，需要借助哨兵值或者指针判断。
一个更优雅的小技巧是先定义变量再注册，配合一个校验辅助函数，把重复的 if 收敛掉：
var (
name string
token string
)
func init() {
flag.StringVar(&name, "name", "", "服务名称（必填）")
flag.StringVar(&token, "token", "", "访问令牌（必填）")
}
func requireFlags(pairs map[string]*string) {
for key, val := range pairs {
if *val == "" {
fmt.Fprintf(os.Stderr, "错误：参数 -%s 为必填项\n", key)
flag.Usage()
os.Exit(1)
}
}
}
func main() {
flag.Parse()
requireFlags(map[string]*string{
"name": &name,
"token": &token,
})
}方案二：环境变量回退加自定义 FlagSet
必填参数在容器化部署场景下还有另一种思路：优先读命令行，没传就去环境变量里找，两边都没有才报错。这种模式在 Kubernetes 生态的工具里非常常见，既保证了脚本调用时参数明确，又方便在容器里用环境变量注入配置。
func stringFlagOrEnv(name, envKey, usage string) *string {
val := flag.String(name, "", usage+"（可用环境变量 "+envKey+" 替代）")
if *val == "" {
*val = os.Getenv(envKey)
}
return val
}
func main() {
token := stringFlagOrEnv("token", "APP_TOKEN", "访问令牌")
flag.Parse()
if *token == "" {
fmt.Fprintln(os.Stderr, "错误：请通过 -token 参数或 APP_TOKEN 环境变量提供令牌")
os.Exit(1)
}
}注意这里有个执行顺序问题：os.Getenv 必须在变量声明阶段调用而不是 flag.Parse 之前的话会拿不到值，上面的写法其实有隐患，正确的做法是把环境变量回退放到 flag.Parse() 之后执行。写这类代码时务必理清楚声明、解析、回退三步的先后顺序，否则会出现环境变量被默认值覆盖的诡异现象。
自定义 flag.FlagSet 则适合需要多个子命令的工具，比如 myapp serve 和 myapp migrate 各有各的参数集合。每个 FlagSet 独立定义 Usage 方法，报错时输出对应子命令的帮助信息，用户体验会好很多。
方案三：用 pflag 同时支持短参数
如果短参数是硬需求，比如想要 -n 等价于 --name，那么标准库 flag 已经无法满足，此时推荐引入 spf13/pflag 这个库。它是 flag 包的直接替代品，API 几乎一致，迁移成本很低，Kubernetes、Helm 等知名项目都在用它。
package main
import (
"fmt"
"os"
flag "github.com/spf13/pflag"
)
func main() {
name := flag.StringP("name", "n", "", "服务名称（必填）")
verbose := flag.BoolP("verbose", "v", false, "输出详细日志")
flag.Parse()
if *name == "" {
fmt.Fprintln(os.Stderr, "错误：必须提供 --name 或 -n 参数")
flag.Usage()
os.Exit(1)
}
fmt.Println("服务：", *name, "详细模式：", *verbose)
}flag.StringP 的第二个参数就是短参数名，用户可以写 -n foo，也可以写 --name foo，两种形式都被接受。pflag 还支持合并短参数的写法，比如 -vc 等价于 -v -c，以及 --name=foo 这种等号连接形式，完全符合 POSIX 和 GNU 的参数风格。
pflag 与 cobra 组合是 Go 社区构建 CLI 的事实标准。如果你的工具后续会长出子命令、自动补全、帮助文档生成这些需求，直接上 cobra 加 pflag 是最省事的技术路线。缺点只有一个：引入了外部依赖。对于只想编译一个小巧单文件的内部工具来说，方案一的手动校验依然是更轻量的选择。
三种方案怎么选
简单总结一下选型思路。参数不多、只需必填校验、追求零依赖，用方案一的手动校验，几十行代码解决问题；部署环境复杂、希望支持环境变量注入配置，用方案二的回退模式；需要短参数、等号赋值、子命令，或者项目本身已经在用 cobra，直接选 pflag。
无论选哪种，都建议做两件事：一是重写 flag.Usage，把必填参数在帮助信息里明确标注出来，减少用户翻文档的次数；二是在校验失败时统一从标准错误输出并返回非零退出码，方便上层脚本通过退出码判断失败原因。把这两个细节做好，工具的专业感会立刻提升一截。