Jinja2 宏内部的换行符会导致模板渲染时出现多余空行，即使启用了 trim_blocks 和 lstrip_blocks 也无效；正确做法是在宏定义内使用 {%- -%} 等空白控制语法，而非在调用处添加连字符。
jinja2 宏内部的换行符会导致模板渲染时出现多余空行，即使启用了 `trim_blocks` 和 `lstrip_blocks` 也无效；正确做法是在宏定义内使用 `{%- -%}` 等空白控制语法，而非在调用处添加连字符。
在 Jinja2 中，宏（macro）本质上是独立的模板片段，其内部的换行和空白不受外部模板配置（如 trim_blocks=True 或 lstrip_blocks=True）影响。这意味着：即使你已全局启用空白修剪，宏体内的换行符仍会原样输出为渲染结果中的空行——这正是问题中 Bob、Jason、James 后多出空行的根本原因。
解决方法是在宏定义内部显式控制空白，使用 Jinja2 的空白控制语法：
-
{%- ... %}：去除左侧空白（包括前导换行和空格） -
%-}：去除右侧空白（包括后续换行） -
{%- ... -%}：同时去除左右两侧空白
因此，应将原始宏：
{% macro print_name(data)%}
{{ data }}
{% endmacro %}
改为：
{% macro print_name(data) %}
{{- data -}}
{% endmacro %}
注意：{{- data -}} 中的 - 分别紧贴花括号，表示移除 data 渲染前后所有空白（含换行）。同时，宏开始与结束标签也建议使用 - 优化（如 {%- macro ... -%} 和 {%- endmacro -%}），但本例中仅 {{- data -}} 已足够消除多余换行。
完整修正后的模板如下：
{% macro print_name(data) %}
{{- data -}}
{% endmacro %}
People {
{% for name in names %}
Name {
{{ print_name(name) }}
}
{% endfor %}
}
✅ 渲染结果将严格符合预期：
People {
Name {
Bob
}
Name {
Jason
}
Name {
James
}
}
⚠️ 注意事项：
-
避免在调用处加
-（如{{ print_name(name) -}}）：这会删除宏输出后的换行，导致后续}顶格缩进，破坏结构； -
trim_blocks=True仅作用于{% ... %}块的外层换行（如{% for %}后的换行），不穿透宏作用域； - 若宏内含多行逻辑（如条件判断、嵌套循环），建议对每个
{{ }}和{% %}标签统一应用-控制，保持空白行为可预测； - 调试时可临时启用
env = Environment(..., autoescape=False, undefined=jinja2.DebugUndefined)快速定位空白来源。
掌握宏内空白控制，是编写健壮、可维护 Jinja2 模板（尤其用于生成 YAML/JSON/Terraform/HCL 等格式敏感配置）的关键实践。
