Jinja2单模板不单独创建环境时如何添加自定义过滤器

报错的核心原因是Jinja2的Template实例在初始化解析模板字符串的阶段，就会完成模板内所有过滤器、标签的合法性校验。你是在Template对象创建完成之后，才往它隐式生成的environment中追加过滤器，此时模板解析校验流程已经结束，新增的过滤器无法被识别。
另外原有代码还存在一处逻辑问题：定义的round_to_even过滤器仅支持处理单个整数，但模板中直接对items列表应用该过滤器，列表类型不支持%2取模运算，就算过滤器注册成功也会触发类型错误。

官方推荐的自定义过滤器注册逻辑是：在模板实例化之前，先把自定义过滤器注册到即将绑定的Environment实例中，哪怕只需要使用单个模板，这种方式的可控性和可维护性也更高。

方式1：通过Environment实例创建模板（最常用） #

先创建配置好参数、注册完自定义过滤器的Environment实例，再通过from_string方法加载模板字符串：

from jinja2 import Environment

TEMPLATE = """
{{ items|round_to_even }}
"""

def main():
    # 初始化环境时统一配置块处理参数
    env = Environment(trim_blocks=True, lstrip_blocks=True)
    # 模板实例化前注册过滤器，直接实现列表批量处理逻辑匹配模板写法
    env.filters['round_to_even'] = lambda arr: [x if x % 2 == 0 else x + 1 for x in arr]
    # 从已配置的环境加载模板
    template = env.from_string(TEMPLATE)
    print(template.render(items=[1, 2, 3]))
    return 0


if __name__ == '__main__':
    main()

运行后会直接输出预期的[2, 2, 4]结果。

方式2：手动传入Environment给Template构造器 #

如果习惯直接使用Template类构造实例，可以提前创建好注册完过滤器的Environment，作为参数传入Template构造函数，确保模板解析阶段就能识别到自定义过滤器：

from jinja2 import Environment, Template

TEMPLATE = """
{{ items|round_to_even }}
"""

def main():
    env = Environment(trim_blocks=True, lstrip_blocks=True)
    env.filters['round_to_even'] = lambda arr: [x if x % 2 == 0 else x + 1 for x in arr]
    # 传入提前配置完成的环境实例
    template = Template(TEMPLATE, environment=env)
    print(template.render(items=[1, 2, 3]))
    return 0


if __name__ == '__main__':
    main()

注意：不要在Template实例创建完成后再修改其绑定的environment的过滤器、全局函数等配置，这类配置不会对已经解析完成的模板生效。

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