本文介绍 Go 语言中使用 flag 包解析无参数布尔型命令行标志（如 -version 或 --version）的正确方法，重点解决因标志名误加短横线导致的“flag provided but not defined”错误。
本文介绍 go 语言中使用 `flag` 包解析无参数布尔型命令行标志（如 `-version` 或 `--version`）的正确方法，重点解决因标志名误加短横线导致的“flag provided but not defined”错误。
在 Go 中，flag 包负责解析命令行参数，但其设计要求标志名（flag name）必须是纯标识符，不包含短横线（- 或 --）。当你写 flag.StringVar(&version, "-version", ...) 时，Go 实际注册了一个名为 -version 的标志——这会导致解析器在遇到 -version 参数时，试图匹配一个名为 -version 的子标志（即 -(-version)），从而触发 flag provided but not defined 错误。
✅ 正确做法是：
- 使用
flag.BoolVar（或其他布尔型标志函数）声明一个布尔变量； - 将标志名设为
"version"（不含-）； -
flag包会自动支持单短横线（-version）和双短横线（--version）两种写法； - 若用户传入该标志，变量值自动设为
true，无需额外赋值。
以下是完整、可运行的示例代码：
package main
import (
"flag"
"fmt"
)
func main() {
var version bool
flag.BoolVar(&version, "version", false, "prints current version and exits")
flag.Parse()
if version {
fmt.Println("v1.2.0") // 替换为你的实际版本号
return
}
// 处理其他非标志参数（如文件路径、子命令等）
args := flag.Args()
if len(args) > 0 {
fmt.Printf("Non-flag arguments: %v\n", args)
} else {
fmt.Println("No additional arguments provided.")
}
}? 关键注意事项：
- ❌ 错误：
flag.BoolVar(&v, "-version", ...)或flag.BoolVar(&v, "--version", ...)—— 短横线属于语法前缀，不属于标志名； - ✅ 正确：
flag.BoolVar(&v, "version", ...)，调用时用-version或--version均可； -
flag.Parse()必须在所有flag.*Var调用之后、业务逻辑之前执行； - 布尔标志默认值建议显式设为
false，增强可读性与可维护性； - 若需支持
-v/--v等简写，可额外注册：flag.BoolVar(&version, "v", false, "shorthand for version")。
通过遵循上述规范，你就能优雅、健壮地实现类似 go run user.go -version 这样的 CLI 体验，同时保持代码简洁与标准兼容性。
