如何使用Golang解析IP地址与端口_Golang net ParseIP与SplitHostPort示例

Go语言中解析IP和端口应组合使用net.ParseIP与net.SplitHostPort:ParseIP安全解析IPv4/IPv6地址但不处理端口;SplitHostPort正确分离host:port格式字符串,支持带方括号的IPv6,再对host调用ParseIP校验并提取IP。

Go 语言中解析 IP 地址和端口是网络编程的常见需求,net 包提供了简洁可靠的工具函数:用 net.ParseIP 解析纯 IP 字符串,用 net.SplitHostPort 拆分“host:port”格式的地址(如 "127.0.0.1:8080""[::1]:3000")。

ParseIP:安全解析 IPv4 和 IPv6 地址

net.ParseIP 能识别标准格式的 IPv4(如 "192.168.1.1")和 IPv6(如 "2001:db8::1" 或带方括号的 "[2001:db8::1]"),但注意它不处理端口号,也不校验是否为有效主机名。遇到非法格式时返回 nil,需手动判空。

  • IPv6 地址若含端口(如 "[::1]:8080"),直接传给 ParseIP 会失败,必须先剥离端口
  • 它自动兼容 IPv4 映射的 IPv6 格式(如 ::ffff:192.0.2.1),返回对应 IPv4 地址
  • 推荐写法:ip := net.ParseIP(s); if ip == nil { /* 错误处理 */ }

SplitHostPort:正确分离 host 和 port 字符串

net.SplitHostPort 专为形如 "host:port" 的字符串设计,能自动识别 IPv6 地址中的方括号(如 "[::1]:8080"),避免手动切分出错。它返回 (host, port, error) 三元组。

  • 输入不含端口(如 "example.com")会报错:"missing port in address"
  • IPv6 地址必须用方括号包裹,否则会被误认为多个冒号分隔——"::1:8080" 是非法格式,应写成 "[::1]:8080"
  • 拆出的 host 可能是域名、IPv4 或带括号的 IPv6;port 是字符串,需用 strconv.Atoi 转为整数

组合使用:安全提取 IP + 端口

典型场景是解析用户输入的监听地址(如命令行参数 --addr=":8080""127.0.0.1:3000")。应先用 SplitHostPort 拆分,再对 host 部分调用 ParseIP 判断是否为 IP。

  • host 是域名(如 "localhost"),ParseIP 返回 nil,此时可后续用 net.LookupIP 解析
  • host 是 IPv6 带括号(如 "[::1]"),ParseIP 会自动去掉括号并解析成功
  • 示例片段:addr := "192.168.1.100:22"; host, portStr, _ := net.SplitHostPort(addr); ip := net.ParseIP(host); port, _ := strconv.Atoi(portStr)

基本上就这些。ParseIP 和 SplitHostPort 各司其职,配合使用就能稳健处理绝大多数网络地址解析场景,不复杂但容易忽略 IPv6 括号和错误判空。