Python ipaddress.summarize_address_range 怎样压缩地址范围

需要把一段连续的 IP 地址交给 ACL、白名单或配置生成器时，不必手写 CIDR 拆分。Python 标准库的 ipaddress.summarize_address_range(first, last) 会把两个同版本地址组成的闭区间汇总成一组网络对象，结果覆盖整个范围，同时尽量减少网络数量。

官方文档：https://docs.python.org/3/library/ipaddress.html#ipaddress.summarize_address_range

先把地址范围转换成可汇总的输入

这个函数的输入不是字符串，也不是带前缀的网络，而是两个地址对象。先显式调用 ip_address()，可以让 IPv4 和 IPv6 的解析保持一致；如果业务已经知道版本，也可以直接构造 IPv4Address 或 IPv6Address。

from ipaddress import ip_address, summarize_address_range

first = ip_address("192.0.2.0")  # 把范围起点解析成地址对象
last = ip_address("192.0.2.130")  # 把范围终点解析成同版本地址对象

networks = list(summarize_address_range(first, last))  # 将迭代器物化，便于返回或序列化
for network in networks:
    print(network.with_prefixlen)  # 用 CIDR 形式读取每个覆盖网络

关键点是“地址对象 + 同一 IP 版本”。不要把 192.0.2.0/24 这样的网络字符串直接作为端点传入；它表达的是一组地址，不是函数要求的单个首地址或末地址。

汇总结果为什么不是固定一个网段

起点和终点通常不会刚好对齐一个 CIDR 边界。函数会从起点开始选择合适大小的网络，再继续覆盖剩余地址，因此结果可能包含多个前缀。例如范围从 192.0.2.0 到 192.0.2.130，不能直接写成 192.0.2.0/25，因为后面的地址还没有被覆盖。

使用时优先保留网络对象，不要马上把它们拼成字符串。网络对象可以继续读取 network_address、prefixlen、broadcast_address，最后在输出边界再使用 with_prefixlen。

for network in summarize_address_range(first, last):
    # 这些字段用于生成配置；函数返回的网络对象仍保持结构化信息。
    item = {
        "cidr": network.with_prefixlen,
        "network": str(network.network_address),
        "prefix_length": network.prefixlen,
        "broadcast": str(network.broadcast_address),
    }
    print(item)  # 接入配置生成器时，可在这里改为 append 或序列化

如果下游只接受 CIDR 文本，才在最后一步取 with_prefixlen。这样可以避免在中间流程里丢失前缀长度和广播地址等信息。

把异常边界放在调用前处理

官方接口对输入边界区分得很清楚：端点不是 IP 地址对象，或者两个端点的版本不同，会得到 TypeError；终点不大于起点，或者版本不属于 IPv4/IPv6，则会得到 ValueError。在批量处理数据时，建议把解析和范围检查放在同一个函数里，让错误带上原始输入。

from ipaddress import ip_address, summarize_address_range

def summarize_range(start_text, end_text):
    # 先解析两端，再检查版本和顺序，避免把异常留给更上层。
    first = ip_address(start_text)
    last = ip_address(end_text)
    if first.version != last.version:
        raise ValueError("起止地址必须使用同一 IP 版本")
    if int(last) 

这里用整数比较只是为了明确顺序判断，不改变最终的地址类型。若输入来自用户或配置文件，还应在函数外捕获 ValueError 和地址解析异常，返回可定位的字段名，而不是吞掉错误后生成一份不完整的白名单。

不要把范围汇总和已有网络合并混用

summarize_address_range() 的问题是“两个地址之间怎么覆盖”；collapse_addresses() 的问题是“我已经有一组网络对象，怎样合并相邻或可合并的网络”。前者接受首尾地址，后者接受网络对象或地址对象的可迭代集合，输入模型不同。

上线前记住这三个检查点

1. 确认输入语义是“地址范围”，而不是“已有网段集合”；两者不要只靠函数名猜。
2. 确认首尾地址同版本，并明确业务是否允许首尾相等；当前接口对 last 会进入值错误分支。
3. 把结构化网络对象留到配置输出边界，再转为 CIDR 字符串，同时保留异常原文和输入字段。

常见问题

为什么不能传两个字符串给 summarize_address_range？

接口要求的是 IPv4Address 或 IPv6Address 对象。先用 ip_address() 解析字符串，并在解析阶段处理无效地址，错误位置更清楚。

IPv4 和 IPv6 可以一起汇总吗？

不可以。两个端点必须属于同一 IP 版本；混用时应拆成两次独立汇总，再由业务层分别处理。