如何在 Go 中正确解析命令行 IP 地址参数

go 的 `flag` 包要求显式调用 `flag.parse()` 才能实际解析命令行参数；若遗漏该步骤，所有标志将保持默认值，导致始终输出 `”127.0.0.1″` 而非用户传入的 ip。

在 go 中使用 flag 包读取命令行参数（如 IP 地址）是一个常见需求，但一个极易被忽略的关键点是：参数绑定（如 flag.Stringvar）仅完成声明，不触发解析。真正的参数解析必须通过显式调用 flag.Parse() 来启动——它会扫描 os.Args[1:]，匹配已注册的标志，并将值写入对应变量。

以下是一个完整、可直接运行的示例：

package main  import (     "flag"     "fmt"     "net" )  func main() {     var ipaddressString string     flag.StringVar(&ipaddressString, "ip", "127.0.0.1", "IP address to bind (e.g., 10.0.0.1)")     flag.Parse() // ✅ 必须放在所有 flag.*Var 调用之后、首次使用参数之前      ip := net.ParseIP(ipaddressString)     if ip == nil {         fmt.Fprintf(flag.CommandLine.Output(), "error: invalid IP address %qn", ipaddressString)         flag.Usage()         return     }     fmt.Printf("Parsed IP: %v (type: %s)n", ip, ip.To4()) }

✅ 正确执行方式：

go run main.go -ip=10.0.0.1      # 输出: Parsed IP: 10.0.0.1 (type: 10.0.0.1) go run main.go -ip="192.168.1.5" # 同样有效（引号在 shell 中可选，Go 自动去除）

⚠️ 注意事项：

• flag.Parse() *必须在所有 `flag.Var调用之后、且在访问参数变量之前调用**；否则变量仍为初始值（此处即”127.0.0.1″`）。
• flag.Parse() 会自动处理 –help 或 -h，并调用 flag.Usage()；你可自定义帮助信息（如重置 flag.Usage）。
• 对于严格校验，建议在 net.ParseIP 后检查返回值是否为 nil，避免静默失败。
• 若需支持 ipv6（如 ::1），net.ParseIP 已兼容，无需额外处理；但注意 ip.To4() 仅对 IPv4 有效，生产环境应根据实际需求选择 .To4() 或 .To16()。

总结：flag 是惰性解析机制——声明 ≠ 赋值。牢记 Parse() 是连接命令行输入与变量值的唯一桥梁。