纯Python项目下Jinja2模板如何区分判断IPv4与IPv6地址

AI 小北

2026-8-30

核心结论

Jinja2 原生不提供IPv4/IPv6地址识别相关的内置过滤器或测试器。你可能见过的is ipv4、ipaddr这类IP处理能力，都是Ansible、Salt等基于Jinja2二次封装的框架自行添加的自定义扩展，纯Python环境下的原生Jinja2没有这个功能。

实现方案

不需要引入任何第三方依赖，直接用Python 3.3+版本自带的ipaddress标准库，给Jinja2环境注册两个自定义测试函数，就能完全匹配你需要的模板逻辑：

先编写两个判断函数，分别校验传入值是否为合法IPv4、IPv6地址，捕获地址格式不合法时抛出的异常返回布尔值
将两个函数注册到Jinja2运行环境的测试集合中，命名和你模板里写的判断名保持一致
修正原模板里的两处语法问题：Jinja2逻辑块的闭合标记是%}不是%%}；生成配置时应该取item["name"]字段而不是整个item对象

Python端注册自定义测试的代码示例

import ipaddress
from jinja2 import Environment

def is_one_ipv4(value):
    try:
        # 如果你要判断的是带掩码的前缀网段，把IPv4Address换成IPv4Network即可
        ipaddress.IPv4Address(value)
        return True
    except (ipaddress.AddressValueError, ValueError):
        return False

def is_one_ipv6(value):
    try:
        # 判断网段时对应换成IPv6Network
        ipaddress.IPv6Address(value)
        return True
    except (ipaddress.AddressValueError, ValueError):
        return False

# 初始化Jinja2环境时注册测试
env = Environment()
env.tests["one_IPV4"] = is_one_ipv4
env.tests["one_IPV6"] = is_one_ipv6

修正后可直接运行的模板代码

{% for item in v['policy-options'] %}
        {% if item["name"] is one_IPV4 %}
            ip prefix-list {{ item["name"] }}
        {% endif %}
        {% if item["name"] is one_IPV6 %}
            ipv6 prefix-list {{ item["name"] }}
        {% endif %}
{% endfor %}