如何在Flask的Jinja2中正确配置使用jinja2-humanize-extension扩展？

问题根因 #

你手动创建的独立Environment实例和Flask框架自身维护的Jinja2渲染环境完全隔离，你在自定义实例上添加的扩展不会被Flask模板渲染逻辑读取，因此过滤器无法识别。

正确配置步骤 #

• 首先确认已安装正确的依赖包：

  pip install jinja2-humanize-extension
  

• 在Flask应用初始化逻辑中，直接修改Flask自带的Jinja环境配置，添加humanize扩展：

  from flask import Flask
  from jinja2_humanize_extension import HumanizeExtension
  
  app = Flask(__name__)
  # 向Flask自带的Jinja环境注册扩展
  app.jinja_env.add_extension(HumanizeExtension)
  

  如果你使用应用工厂模式创建Flask实例，将注册扩展的逻辑放在工厂函数内、返回app实例之前即可。
• 你此前编写的独立env = Environment(extensions=["jinja2_humanize_extension.HumanizeExtension"])代码无实际作用，可以直接删除避免逻辑混淆。

模板写法验证 #

你当前的模板写法符合规范，无额外参数时过滤器也可以省略括号：

<small class="text-muted">Time remaining: {{ (submission.date_expiration - now)|naturaldelta }}</small>

异常排查 #

如果配置完成后仍然报错，按以下顺序排查：

1. 确认扩展注册逻辑在Flask实例初始化完成后、第一次模板渲染前执行
2. 重启Flask开发服务器，清除旧的环境缓存
3. 检查扩展类名、过滤器名称的拼写是否正确

内容的提问来源于stack exchange，提问作者Adventure-Knorrig