Go netip.Addr.Prev 怎样获取前一个 IP 地址

结论先说：netip.Addr.Prev() 返回当前 IP 地址之前的一个地址；如果当前地址已经是该地址族的最小值，或者接收者本身是零值，就返回零值 netip.Addr{}。因此调用后不要只看 String()，应优先用 IsValid() 判断结果是否还能继续使用。

官方文档：https://pkg.go.dev/net/netip#Addr.Prev

Prev 到底返回什么

Addr 是 net/netip 提供的不可变值类型。调用 ip.Prev() 不会修改原来的 ip，而是返回一个新的地址值。对于普通地址，IPv4 会按数值减一，IPv6 也会按 128 位地址空间向前移动一位。

它的边界设计很适合遍历：没有前一个地址时不返回 error，而是返回零值。这个零值不是 0.0.0.0，也不是 ::；它代表未初始化的 Addr，可用 IsValid() 识别。

先解析输入，再调用 Prev

外部配置、请求参数或文件内容都可能不是合法 IP。先用 netip.ParseAddr 得到可检查的错误，再调用 Prev，可以把“输入格式错误”和“已经到达边界”分成两类处理。

package main

import (
	"fmt"
	"net/netip"
)

func previousAddress(text string) (netip.Addr, error) {
	// 先验证文本格式，避免把解析失败误认为 Prev 的边界结果。
	ip, err := netip.ParseAddr(text)
	if err != nil {
		return netip.Addr{}, fmt.Errorf("解析 IP 失败: %w", err)
	}

	// Prev 不改变 ip，只返回它前面的地址。
	previous := ip.Prev()
	if !previous.IsValid() {
		// 零值表示已经没有更小的地址，不是一个可继续使用的 IP。
		return netip.Addr{}, fmt.Errorf("地址 %s 已经位于地址空间起点", ip)
	}
	return previous, nil
}

func main() {
	previous, err := previousAddress("192.0.2.10")
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(previous) // 192.0.2.9
}

这里的 Addr{} 只作为错误返回值使用。若业务需要区分“输入为空”和“地址已到边界”，可以额外定义哨兵错误或返回一个布尔值，但不要把零值直接当成可发送、可存储的 IP。

IPv4、IPv6 与零值边界怎么区分

最容易混淆的是三个概念：Addr{} 是无效零值，0.0.0.0 是有效 IPv4 未指定地址，:: 是有效 IPv6 未指定地址。Prev 在最小有效地址上返回的是前者。

package main

import (
	"fmt"
	"net/netip"
)

func showPrev(text string) {
	// MustParseAddr 只适合这里的固定示例；生产输入应使用 ParseAddr。
	ip := netip.MustParseAddr(text)
	previous := ip.Prev()
	if previous.IsValid() {
		fmt.Printf("%s -> %s\n", ip, previous)
		return
	}

	// IsValid 识别的是 Addr{}，不要用 String() 是否为空替代语义判断。
	fmt.Printf("%s -> 没有前一个地址，返回零值\n", ip)
}

func main() {
	showPrev("0.0.0.0")
	showPrev("::")
	showPrev("192.0.2.1")
	showPrev("2001:db8::1")
}

对于 IPv4，0.0.0.0 再向前就没有地址；对于 IPv6，:: 再向前同样没有地址。两者都是合法的输入，但它们的 Prev 结果都应按零值处理。

用 Prev 和 Next 遍历地址范围

如果程序需要从一个地址向前枚举，循环条件应在进入业务处理前检查 IsValid。原始地址保留在变量中，下一轮再把 Prev 的返回值赋回去，逻辑会比修改字节切片更容易读。

package main

import (
	"fmt"
	"net/netip"
)

func walkBackward(start netip.Addr, limit int) {
	current := start
	for i := 0; i 

limit 是工程上的保护条件：即使输入合法，也不要让不受控的地址遍历占满循环。若要在 IPv4 与 IPv6 之间统一处理，直接使用 Addr 即可；但不要跨地址族做“减一”的业务假设，IPv4 和 IPv6 各自拥有独立的地址空间。

带 zone 的 IPv6 地址要注意什么

链路本地 IPv6 可能带区域标识，例如 fe80::10%eth0。Prev 仍然返回前一个地址值，区域标识属于地址的一部分，会随结果保留。若业务要比较不同接口上的地址，先明确是否应保留 zone，不要仅凭去掉 zone 后的字符串作权限或路由判断。

package main

import (
	"fmt"
	"net/netip"
)

func main() {
	// ParseAddr 支持带 zone 的 IPv6 文本，zone 用于标识作用域接口。
	ip, err := netip.ParseAddr("fe80::10%eth0")
	if err != nil {
		fmt.Println(err)
		return
	}

	previous := ip.Prev()
	// 用 String 展示地址时会看到 zone；实际业务仍应先检查 IsValid。
	fmt.Println(previous, previous.Zone())
}

Prev 与相邻 API 怎么选

常见问题

Prev 会修改原来的 Addr 吗？

不会。Addr 是值类型，Prev 返回新值；只有把结果重新赋回变量，遍历位置才会改变。

为什么 Prev 不返回 error？

地址空间边界是可预期的遍历结果，不是输入格式错误。API 用零值表达“没有前一个地址”，调用方用 IsValid 判断即可。

能用 Prev 计算网段的前一个网段吗？

不能直接把它当作网段运算。Prev 只移动一个 IP 地址；网段边界、前缀长度和重叠判断应使用 netip.Prefix 的相关方法单独处理。

实际使用时可以记住一条规则：先解析并检查输入，调用 Prev 后立即检查结果的 IsValid，再进入发送、存储或范围遍历逻辑。这样既能覆盖普通 IPv4/IPv6 地址，也能把地址空间边界处理得清楚。