应使用 net.splithostport 安全解析网络地址，它自动兼容 ipv4/ipv6、避免手动切分错误；对无端口地址需捕获 "missing port" 错误并补默认端口，ipv6 返回的 host 需用 strings.trim(host, "[]") 清理方括号。
net.SplitHostPort 解析失败的常见错误
直接调用 net.SplitHostPort 时最常遇到的是 "address xxx: missing port in address" 或 "address xxx: too many colons in address"。这不是函数 bug，而是它严格遵循 RFC 3986 —— IPv6 地址必须用方括号包裹，否则冒号会被误判为分隔符。
- ❌ 错误写法：
net.SplitHostPort("2001:db8::1:8080")→ 报too many colons - ✅ 正确写法：
net.SplitHostPort("[2001:db8::1]:8080") - ✅ 普通 IPv4 或域名：
net.SplitHostPort("example.com:3000")或net.SplitHostPort("127.0.0.1:8080")
如何安全处理不带端口的地址（如 "localhost"）
net.SplitHostPort 要求输入必须含端口，不支持默认端口推导。如果你拿到的是无端口地址（比如配置项只写了 host: "api.example.com"），不能直接传入，否则 panic。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 先检查字符串是否含
:；但注意：IPv6 字面量里也有冒号，所以不能简单按:切分 - 更稳妥的做法是：尝试调用
net.SplitHostPort，捕获 error；若失败且错误信息含"missing port"，再手动补默认端口（如":443"或":80"）后重试 - 示例逻辑：
addr := "api.example.com"<br>host, port, err := net.SplitHostPort(addr)<br>if err != nil && strings.Contains(err.Error(), "missing port") {<br> host, port, err = net.SplitHostPort(net.JoinHostPort(addr, "443"))<br>}
解析结果中 host 可能带方括号，需清理后再使用
当输入是 IPv6 地址（如 "[::1]:8080"），net.SplitHostPort 返回的 host 是 "[::1]"，不是 "::1"。很多下游库（如 http.Client、net.Dial）能接受带括号的 host，但部分自定义逻辑或日志打印时可能出问题。
- 用
strings.Trim(host, "[]")去掉括号是最轻量的方式 - 不要用正则或复杂切片 —— IPv6 地址本身合法字符有限，且只有首尾可能是
[和] - 注意：清理后得到的字符串不保证是有效 IP，仅用于展示或构造新地址；真正建连仍建议用原始
host:port字符串或net.ParseIP验证
替代方案：用 net.ParseIP + 自定义端口提取更可控？
如果业务逻辑需要区分 IPv4/IPv6、校验 IP 合法性、或允许省略端口+自动 fallback，net.SplitHostPort 就不够用了。此时可组合使用 net.ParseIP 和字符串处理。
- 先用
net.ParseIP尝试解析整个字符串 —— 若成功，说明没端口，按需补默认端口 - 若失败，再用
net.SplitHostPort解析；若仍失败，说明格式非法 - 注意：
net.ParseIP("127.0.0.1:8080")返回 nil，因为它不认端口，这点和SplitHostPort的职责边界要分清 - 真正难处理的是混合场景：用户可能输
"[::1]"、"::1"、"localhost:3000"、"unix:///tmp/sock"—— 这时建议统一走 URL 解析（url.Parse）或用专用库如github.com/miekg/dns的地址工具
