Go标准库flag包轻量高效，支持基础类型参数、自动帮助信息和错误处理；需用flag.String等声明参数指针，调用flag.Parse()解析；支持短长选项绑定、自定义Value类型及位置参数提取。
Go 标准库中的 flag 包轻量、高效、无需额外依赖，适合构建简洁的命令行工具。它支持字符串、整数、布尔值等基础类型，并能自动处理帮助信息（-h/--help）和参数解析错误。
定义并解析常用参数
使用 flag.String、flag.Int、flag.Bool 等函数声明参数变量，每个函数返回对应类型的指针。调用 flag.Parse() 后，参数值就已写入这些变量中。
示例：
package main
import (
"flag"
"fmt"
)
func main() {
// 定义参数：-name 默认为 "world"，-age 默认为 0，-verbose 默认为 false
name := flag.String("name", "world", "your name")
age := flag.Int("age", 0, "your age in years")
verbose := flag.Bool("verbose", false, "enable verbose output")
flag.Parse() // 必须调用，否则参数不会被解析
fmt.Printf("Hello, %s!\n", *name)
if *age > 0 {
fmt.Printf("You are %d years old.\n", *age)
}
if *verbose {
fmt.Println("Verbose mode is on.")
}
}
运行效果：
立即学习“go语言免费学习笔记（深入）”；
-
go run main.go -name Alice -age 25 -verbose→ 输出完整信息 -
go run main.go -h→ 自动打印帮助文本（含参数名、默认值、说明） -
go run main.go -age abc→ 报错：invalid value "abc" for flag -age: strconv.ParseInt: parsing "abc": invalid syntax
支持短选项与长选项（如 -v 和 --verbose）
flag 包原生只支持单横线短选项（如 -v），但可通过两次调用实现兼容长选项：
- 先用
flag.Bool("v", false, "...")支持-v - 再用
flag.Bool("verbose", false, "...")支持--verbose
两者会绑定到同一个变量（需共用指针）。更推荐的做法是统一用长选项名，再通过别名方式注册短选项：
verbose := flag.Bool("verbose", false, "enable verbose output")
flag.BoolVar(verbose, "v", false, "same as -verbose") // 绑定到同一变量
这样 -v 和 --verbose 效果完全一致，且帮助信息中会同时显示。
自定义参数类型与非标准格式
当需要解析 IP 地址、时间、CSV 列表等复杂格式时，可实现 flag.Value 接口：
- 定义结构体，实现
Set(string) error和String() string - 用
flag.Var(你的实例, "name", "help text")注册
例如解析多个文件路径：
type fileList []string
func (f *fileList) Set(value string) error {
*f = append(*f, value)
return nil
}
func (f *fileList) String() string { return fmt.Sprint([]string(*f)) }
// 使用：
var files fileList
flag.Var(&files, "file", "input file (can be repeated)")
之后可多次传入：-file a.txt -file b.txt -file c.txt，files 就是 ["a.txt","b.txt","c.txt"]。
区分命令行参数与 flag 参数
flag.Parse() 会把第一个非 flag 的参数及之后所有内容放入 flag.Args()，可用于子命令或位置参数。
-
flag.Arg(i)获取第 i 个位置参数（从 0 开始） -
flag.Args()返回剩余所有参数切片 -
flag.NArg()返回位置参数个数
例如实现类似 git commit -m "msg" file1.go file2.go 的结构：
msg := flag.String("m", "", "commit message")
flag.Parse()
if *msg == "" {
fmt.Fprintln(os.Stderr, "error: -m is required")
os.Exit(1)
}
files := flag.Args() // ["file1.go", "file2.go"]
fmt.Printf("Committing %d files with message: %s\n", len(files), *msg)
基本上就这些。flag 虽小，但覆盖了绝大多数 CLI 场景。不复杂但容易忽略的是：记得调用 flag.Parse()，且必须在所有 flag 声明之后、使用之前。
