Jinja2模板sameas()相等性测试规则及与普通等于测试的区别

核心本质 #

sameas() 是Jinja2内置的测试方法，作用是检查两个对象是否指向内存中的同一个实例，等价于Python语法中的is运算符，和常规相等测试==的逻辑完全不同：==仅判断两个对象的值是否相等，不校验内存地址是否一致。

是否仅能用于布尔值校验？ #

不是。
该方法常被用于布尔值、None的校验，是因为Python中True、False、None都是全局唯一的单例对象，使用sameas()校验可以避免隐式类型转换导致的误判：比如0 == False会返回True，但0 is sameas(False)只会在对象确实是布尔值False时才返回True，逻辑更严谨。

其他适用场景 #

• 校验单例类型实例：除了布尔值和None，还可用于校验枚举类成员、自定义单例类的实例等全局唯一的对象，避免值相等但实例不匹配的误判。
• 可变对象的身份校验：对于列表、字典等可变对象，如果你需要判断两个变量是不是指向同一个实例（而非仅仅内容相同），就需要用到sameas()，比如判断当前遍历的列表是否是你提前注入到模板上下文的特定全局列表。
• 严格的类型匹配校验：当你需要排除隐式类型转换的干扰时，使用sameas()比==更可靠，比如需要严格区分布尔值True和整数1的场景。

示例代码 #

{% set list1 = [1,2,3] %}
{% set list2 = [1,2,3] %}
{% set list3 = list1 %}

{{ list1 == list2 }}         {# 输出：True，值相等 #}
{{ list1 is sameas(list2) }} {# 输出：False，不是同一个实例 #}
{{ list1 is sameas(list3) }} {# 输出：True，指向同一个实例 #}

{{ 1 == True }}              {# 输出：True，隐式类型转换 #}
{{ 1 is sameas(True) }}      {# 输出：False，严格校验实例 #}

官方说明：sameas()的核心作用是检查对象是否指向相同的内存地址。

内容的提问来源于stack exchange，提问作者penguin02007