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。
立即学习“go语言免费学习笔记(深入)”;
- 若
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 括号和错误判空。










