如何使用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 括号和错误判空。