Jinja拼接含未定义项的可选变量时如何避免产生多余重复空格

我希望在Jinja中实现多变量拼接，变量之间严格使用单个空格（' '）分隔，但其中部分变量可能为未定义状态，模板无法预先确定哪些变量未定义。

初始实现代码如下：

import jinja2

template = jinja2.Template('{{ title }} {{ first }} {{ middle }} {{ last }}')
result = template.render(first='John', last='Doe')  # result == ' John  Doe'

仅传入first='John'、last='Doe'参数时，默认模板输出结果为' John Doe'，需要找到可替代的模板字符串写法，让该场景下输出结果为'John Doe'。

方案1：列表过滤后拼接 #

使用如下模板写法：

{{ [title, first, middle, last]|reject("undefined")|join(" ") }}

该写法可以实现基础的空值过滤拼接，但存在两点不足：

• 写法可读性差，列表嵌套过滤器的形式容易造成混淆
• 如果需要对其中某个参数单独做格式化处理（例如middle变量存在时为其添加括号，未定义时返回空字符串），该方案无法灵活适配

方案2：连续空格替换 #

最初尝试用普通替换过滤器处理多余空格：

{% filter replace("  ", " ") -%}
{{ title }} {{ first }} {{ middle }} {{ last }}
{%- endfilter %}

该写法只能替换两个连续空格的场景，无法覆盖3个及以上连续空格的情况。如果改用正则替换适配所有多空格场景：

{% filter regex_replace(" +", " ") -%}
{{ title }} {{ first }} {{ middle }} {{ last }}
{%- endfilter %}

又存在两个问题：

• regex_replace不是Jinja内置过滤器，需要额外自定义正则过滤器才能使用
• 正则会把变量内容本身包含的连续空格一并替换，不符合需求

方案1：纯模板宏实现（无后端依赖） #

不需要修改Jinja后端配置，直接在模板中定义可复用的拼接宏即可，支持对单个变量做任意自定义格式化：

{# 定义拼接宏 #}
{% macro join_spaced(*parts) %}
{% set valid_parts = [] %}
{% for part in parts %}
  {% if part is defined and part is not none and part|string|trim != '' %}
    {% set _ = valid_parts.append(part) %}
  {% endif %}
{% endfor %}
{{ valid_parts|join(' ') }}
{% endmacro %}

{# 调用示例，支持给middle单独加括号逻辑 #}
{{ join_spaced(
  title,
  first,
  '(' ~ middle ~ ')' if middle is defined else '',
  last
) }}

传入first='John', last='Doe'时输出为John Doe；如果传入first='John', middle='Michael', last='Doe'，输出为John (Michael) Doe，完全符合需求，且不会修改变量内部自带的空格。

方案2：自定义过滤器实现（适合高频使用场景） #

如果这类拼接需求较多，可以在Python端自定义一个专用过滤器，模板写法更简洁：

import jinja2
from jinja2 import Undefined

def join_defined(parts, sep=' '):
    valid_parts = []
    for p in parts:
        if isinstance(p, Undefined) or p is None:
            continue
        p_str = str(p).strip()
        if p_str:
            valid_parts.append(p_str)
    return sep.join(valid_parts)

env = jinja2.Environment()
env.filters['join_defined'] = join_defined

模板中直接调用即可，同样支持单变量自定义格式化：

{{ [
  title,
  first,
  '(' ~ middle ~ ')' if middle is defined else '',
  last
]|join_defined }}

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