Go net.IP.Equal 怎样判断两个 IP 是否相同

在 Go 里判断两个 net.IP 是否表示同一个地址，直接调用 ip.Equal(other)。它不要求两个切片长度相同：4 字节 IPv4 与带 IPv4-mapped 前缀的 16 字节表示也会被认为相等；两个正常 IPv6 地址则按 16 字节内容比较。空值、非法长度和“属于同一网段”是另外三类问题，不能混在一次 Equal 判断里。

官方地址：https://pkg.go.dev/net#IP.Equal

先看懂 net.IP 的两种 IPv4 表示

net.IP 底层是字节切片。标准库接受 4 字节 IPv4，也接受 16 字节 IPv6；其中形如 00...00 ff ff c0 00 02 01 的 16 字节值是 IPv4-mapped IPv6，语义上仍然表示一个 IPv4 地址。判断“长度不同就一定不是同一个 IP”会漏掉这个情况。

直接调用 Equal 判断地址等价

最小写法是先用 net.ParseIP 解析文本，再检查解析结果是否为 nil，最后调用 Equal。如果要表达“两个地址相同”，不要把判断写成 ip.String() == other.String()，因为字符串格式化是展示层行为，Equal 才是地址语义判断。

package main

import (
    "fmt"
    "net"
)

func sameIP(leftText, rightText string) (bool, error) {
    // ParseIP 失败返回 nil；先把输入错误和“不相等”区分开。
    left := net.ParseIP(leftText)
    right := net.ParseIP(rightText)
    if left == nil || right == nil {
        return false, fmt.Errorf("无效 IP：%q 或 %q", leftText, rightText)
    }

    // Equal 按地址语义比较，并兼容 IPv4 与 IPv4-mapped IPv6。
    return left.Equal(right), nil
}

func main() {
    pairs := [][2]string{
        {"192.0.2.1", "192.0.2.1"},
        {"192.0.2.1", "::ffff:192.0.2.1"},
        {"2001:db8::1", "2001:db8::2"},
    }
    for _, pair := range pairs {
        equal, err := sameIP(pair[0], pair[1])
        if err != nil {
            fmt.Println("解析失败：", err)
            continue
        }
        fmt.Printf("%s == %s：%v\n", pair[0], pair[1], equal)
    }
}

示例中的第二组会返回 true，这正是 Equal 与简单的切片长度比较、字符串比较的区别。解析失败应单独返回错误，不能把错误输入静默当成“两个地址不同”。

Equal 的内部比较边界

从实现看，Equal 的决策可以压缩成三步：长度相同就逐字节比较；一边是 4 字节、另一边是 16 字节时，检查 16 字节值前 12 字节是否是 IPv4-mapped 前缀，再比较末尾 4 字节；其他长度组合直接返回 false。因此它不会把任意 16 字节数据都当成 IPv4，也不会为非法长度猜测地址。

nil 和非法长度要先分层处理

net.ParseIP 失败时会返回 nil。而手工构造的 net.IP{192, 0, 2} 只有 3 个字节，也不是有效的 IPv4 或 IPv6 表示。虽然 Equal 本身会对不匹配长度返回 false，业务层仍然应该在进入比较前标记输入无效，避免把“数据损坏”误报成普通的不相等。

package main

import (
    "fmt"
    "net"
)

func validIP(ip net.IP) bool {
    // To4 能识别 IPv4 与 IPv4-mapped IPv6；To16 能识别普通 IPv6。
    return ip != nil && (ip.To4() != nil || (ip.To16() != nil && ip.To4() == nil))
}

func compareParsed(left, right net.IP) (bool, error) {
    // 先校验输入，再调用 Equal，保证 false 不会掩盖坏数据。
    if !validIP(left) || !validIP(right) {
        return false, fmt.Errorf("输入不是有效的 IPv4 或 IPv6 地址")
    }
    return left.Equal(right), nil
}

func main() {
    left := net.ParseIP("192.0.2.1")
    right := net.IP{192, 0, 2} // 故意构造非法长度，演示错误分支。
    equal, err := compareParsed(left, right)
    fmt.Println("equal:", equal, "error:", err)
}

如果输入来自配置文件、HTTP 参数或数据库，应在解析入口记录原始字段和错误原因；如果输入已经由可信的 ParseIP 产生，可以直接调用 Equal，不必重复做字符串格式化。

为什么不要用字符串比较

字符串比较只适合比较已经约定好格式的文本，不适合表达 IP 地址等价。例如 IPv6 可以使用压缩写法，IPv4 也可能从 4 字节或 IPv4-mapped 形式进入程序。用 String 做展示，用 Equal 做语义比较，职责更清晰。

package main

import (
    "fmt"
    "net"
)

func main() {
    // 两种 IPv6 文本写法可能格式不同，但解析后代表同一地址。
    compact := net.ParseIP("2001:db8::1")
    expanded := net.ParseIP("2001:0db8:0:0:0:0:0:1")

    // String 负责规范化展示，Equal 负责地址语义判断。
    fmt.Println("字符串相等：", compact.String() == expanded.String())
    fmt.Println("地址相等：", compact.Equal(expanded))
}

需要判断网段时改用 CIDR

Equal 只回答“两个地址是不是同一个地址”，不会回答“某地址是否属于某个网段”。如果需求是判断 192.0.2.17 是否属于 192.0.2.0/27，应把带前缀的网络交给 net.ParseCIDR，再调用 IPNet.Contains。

package main

import (
    "fmt"
    "net"
)

func main() {
    // CIDR 明确表达网段范围，不让 Equal 承担包含判断。
    _, network, err := net.ParseCIDR("192.0.2.0/27")
    if err != nil {
        fmt.Println("网段解析失败：", err)
        return
    }

    candidate := net.ParseIP("192.0.2.17")
    if candidate == nil {
        fmt.Println("地址解析失败")
        return
    }
    fmt.Println("属于网段：", network.Contains(candidate))
}

常见误区

• 看到长度不同就返回 false。 先考虑 4 字节 IPv4 与 IPv4-mapped 16 字节表示。
• 把 nil 当成普通地址。 ParseIP 失败应返回输入错误，不能只记录“不相等”。
• 用 String 比较地址。 String 是展示格式，Equal 才是语义比较。
• 用 Equal 判断网段包含。 网段范围应由 ParseCIDR 和 IPNet.Contains 表达。

小结

net.IP.Equal 是判断两个 IP 是否等价的直接 API：同长度按字节比较，4 字节 IPv4 与同地址的 IPv4-mapped 16 字节形式也视为相等，非法长度不会被猜成有效地址。把解析错误、单地址比较和网段包含拆成三层，代码就不容易出现“格式不同误判”或“坏输入被吞掉”的问题。

相关问题

net.IP.Equal 会判断两个地址是否在同一网段吗？

不会。它只判断两个地址是否相同；网段关系请使用 net.ParseCIDR 与 IPNet.Contains。

IPv4 和 IPv4-mapped IPv6 调用 Equal 会相等吗？

只要 16 字节值使用标准 IPv4-mapped 前缀并且末尾 4 字节相同，Equal 会把它们视为同一个地址。

解析失败后直接调用 Equal 安全吗？

调用本身不会替你修复输入。应先检查 ParseIP 返回的 nil，把无效输入作为错误处理，再对有效地址做 Equal。