如何在 Golang 中验证字符串是否为合法的 IP 地址

Go 标准库的 net.ParseIP 是一个经常被误用的工具。很多开发者以为它能一劳永逸地解决 IP 地址校验问题，但实际上，它既不能直接区分 IPv4 和 IPv6，对诸如 "192.168.01.1" 这类带前导零的非法格式，也只会静默返回 nil。简单来说，它并不能作为“合法 IP”验证的充分条件。

那么，怎样才能在 Golang 中构建一个真正健壮的 IP 地址校验逻辑？这需要从几个层面来拆解。

用 net.ParseIP 搭配显式类型与格式校验

如果只调用 net.ParseIP，它会接受 "192.168.001.001" 这样的字符串。这在 RFC 标准中并不推荐，因为 Docker、Kubernetes 等系统很可能直接拒绝。所以，必须额外增加判断步骤：

• 首先用 net.ParseIP 解析，返回 nil 就直接判定为非法。
• 接着用 ip.To4() 检查是否为有效的 IPv4（不为 nil 且长度为 4 字节）。判断 IPv6 可以用 len(ip) == 16，但要注意排除 IPv4-mapped IPv6 地址，例如 ::ffff:192.168.1.1 长度也是 16 字节。
• 对于 IPv4，建议再走一步：用正则表达式或分段检查的方式，看是否包含前导零，比如 "01" 或 "00" 都是可疑的。

用 strings.Count 做快速预筛

在高并发场景下，提前拦截明显不合法的格式能有效减少后续解析开销。简单来说：

• IPv4 字符串必须恰好包含 3 个 .，且不能包含 :。
• IPv6 字符串必须至少包含 1 个 :，且不能包含 .（除非是 IPv4-mapped 这种特例，但用户输入里极少出现）。
• 整体长度应该控制在合理范围内，比如 2 到 39 个字符，明显过长或过短的可以直接拒绝。

一个简单的实现思路是这样的：

func isValidIP(s string) bool {
    if strings.Count(s, ".") == 3 && strings.Count(s, ":") == 0 {
        return isValidIPv4(s)
    }
    if strings.Count(s, ":") >= 1 && strings.Count(s, ".") == 0 {
        return net.ParseIP(s) != nil
    }
    return false
}

处理 CIDR 与带端口的特殊格式

用户输入里藏了什么坑？最常见的就是混入了 CIDR 掩码（如 "192.168.1.1/24"）或端口号（如 "[::1]:8080"）。net.ParseIP 对这些无能为力。

• 如果字符串包含 /，先用 strings.SplitN(s, "/", 2) 提取出 IP 部分，再做校验。
• 如果字符串包含 : 并且有方括号（比如 "[::1]:8080"），先用 strings.TrimPrefix 去掉 [ 和 ]，再解析。
• 如果是像 "192.168.1.1:80" 这样纯端口但没括号的情况，就先 strings.SplitN(s, ":", 2) 分离，然后只校验前半段的 IP。

别忘了 Unicode 和空白字符

最后这一点很多人会忽略。用户从别处粘贴的字符串，很可能带有不可见字符（比如零宽字符），或者首尾有空格。net.ParseIP 对空格很敏感，" 192.168.1.1 " 会直接返回 nil。

• 务必先执行 strings.TrimSpace 清理空白。
• 如果需要严格限制在 ASCII 范围内，可以遍历每个字节，检查是否在 0x20–0x7E 区间。这样可以避免全角数字（如 １２３）这类 Unicode 字符被误判为合法 IP。

结论：真正健壮的 IP 校验，从来不是调用一个函数那么简单。它需要兼顾协议规范、实际运行环境的限制、用户的输入习惯，还得处理那些隐藏在空格和零宽字符里的“陷阱”。把这些细节都纳入考虑，才算得上是一个可靠的方案。