在Go语言的标准库中，flag包提供了便捷的命令行参数解析能力，当我们传入不符合要求的参数时，flag包会自动输出默认的Usage信息，但默认的提示内容往往比较简单，无法满足复杂的业务场景需求，因此需要自定义Usage输出。
flag包默认Usage的行为
我们先看一个最简单的flag使用示例，观察默认Usage的输出效果。
package main
import (
"flag"
"fmt"
)
func main() {
name := flag.String("name", "default_name", "输入用户名")
age := flag.Int("age", 0, "输入年龄")
flag.Parse()
fmt.Printf("name: %s, age: %dn", *name, *age)
}
当我们运行go run main.go --help时，会输出如下默认的Usage信息：
Usage of main:
-age int
输入年龄
-name string
输入用户名 (default "default_name")
如果传入错误的参数，比如go run main.go -wrong，也会输出类似的提示，并且程序会直接退出。默认的Usage格式固定，无法添加自定义的前缀说明、使用示例或者额外的提示内容。
自定义Usage的核心方法
flag包提供了一个公开的变量flag.Usage，它是一个函数类型的变量，默认指向一个输出默认Usage的函数。我们只需要重新给这个变量赋值，就可以替换默认的Usage输出逻辑。
需要注意的是，flag.Usage的赋值操作必须在flag.Parse()调用之前完成，否则参数解析时使用的还是默认的函数。
基础自定义示例
我们可以在程序初始化阶段，给flag.Usage赋值一个自定义的函数，在函数内部编写我们需要输出的内容。
package main
import (
"flag"
"fmt"
"os"
)
func main() {
// 自定义Usage函数，在flag.Parse之前赋值
flag.Usage = func() {
fmt.Fprintf(os.Stderr, "这是一个自定义命令行工具n")
fmt.Fprintf(os.Stderr, "使用方法: %s [参数]n", os.Args[0])
fmt.Fprintf(os.Stderr, "支持的参数列表:n")
flag.PrintDefaults() // 输出默认的参数说明
}
name := flag.String("name", "default_name", "输入用户名")
age := flag.Int("age", 0, "输入年龄")
flag.Parse()
fmt.Printf("name: %s, age: %dn", *name, *age)
}
运行go run main.go --help，输出的Usage信息会变成：
这是一个自定义命令行工具
使用方法: main [参数]
支持的参数列表:
-age int
输入年龄
-name string
输入用户名 (default "default_name")
更灵活的自定义方式
如果我们需要完全控制Usage的输出内容，不依赖flag.PrintDefaults()，也可以自己手动拼接输出的文本，比如添加更多的使用说明、示例或者版权信息。
package main
import (
"flag"
"fmt"
"os"
)
func main() {
flag.Usage = func() {
// 输出自定义头部信息
fmt.Fprintf(os.Stderr, "自定义命令行工具 v1.0n")
fmt.Fprintf(os.Stderr, "功能: 接收用户名和年龄参数并输出n")
fmt.Fprintf(os.Stderr, "n使用方法:n")
fmt.Fprintf(os.Stderr, " %s -name 张三 -age 20n", os.Args[0])
fmt.Fprintf(os.Stderr, "n参数说明:n")
fmt.Fprintf(os.Stderr, " -name stringt用户名，默认值为default_namen")
fmt.Fprintf(os.Stderr, " -age intt用户年龄，默认值为0n")
fmt.Fprintf(os.Stderr, "n更多帮助请查看项目文档n")
}
name := flag.String("name", "default_name", "输入用户名")
age := flag.Int("age", 0, "输入年龄")
flag.Parse()
fmt.Printf("name: %s, age: %dn", *name, *age)
}
这种方式可以完全按照需求定制输出内容，适合需要更规范提示信息的命令行工具场景。
注意事项
- 自定义
flag.Usage的赋值必须放在flag.Parse()之前，否则不会生效。 - Usage函数的输出通常建议输出到标准错误流
os.Stderr，符合命令行工具的通用规范。 - 如果同时需要自定义参数错误时的退出行为，可以结合
flag.Parse()的错误处理来实现，不过默认情况下flag解析出错会自动调用Usage并退出，自定义Usage后这个行为仍然会保留。
总结
自定义Go中flag包的Usage输出核心就是替换flag.Usage变量对应的函数，我们可以选择在自定义函数中调用flag.PrintDefaults()来复用默认的参数说明，也可以完全手动编写输出内容。通过这种方式，我们可以让命令行工具的提示信息更清晰、更符合项目需求，提升工具的使用体验。