如何格式化Django模板且不在输出中产生多余空白？

针对用Django模板生成TXT文件时，模板代码因不能随意换行导致可读性差，而{% spaceless %}又会破坏必要输出格式的问题，给你几个实用方案：

方案一：用单行注释分隔模板代码，区分模板换行与输出换行 #

利用Django的单行注释{# #}可完全忽略注释内容的特性，在模板标签之间插入带换行的单行注释，实现模板代码的换行排版，同时不影响输出内容。需要输出换行的位置（比如列表项前）直接保留换行即可。

优化后的模板示例：

[{% if foo.condition %}{#
#}x{#
#}{% else %}{#
#} {# 这里保留空格，用于输出空白字符 #}{#
#}{% endif %}] List of requirements fulfilled: {{ foo.requirements_fullfilled }} of {{ foo.num_requirements }}{#
#}{% for requirement in foo.requirement %}{#
#}- {{ requirement.number }}{% if requirement.name %}: {{ requirement.name }}{% endif %}{#
#}{% endfor %}

这样模板代码按逻辑分行，可读性大幅提升，同时输出的换行只出现在你需要的列表项位置。

方案二：封装逻辑到自定义模板标签/过滤器 #

把复杂的格式拼接、条件判断逻辑放到Python代码中，通过自定义模板标签暴露给模板调用，模板只需要一行代码即可完成输出，彻底解决模板代码混乱的问题。

自定义模板标签示例： #

# 在app的templatetags目录下创建requirements_tags.py
from django import template

register = template.Library()

@register.simple_tag
def render_requirements_summary(foo):
    # 处理条件字符
    condition_char = 'x' if foo.condition else ' '
    # 生成摘要行
    summary = f"[{condition_char}] List of requirements fulfilled: {foo.requirements_fullfilled} of {foo.num_requirements}"
    # 生成需求列表行
    req_lines = []
    for req in foo.requirement:
        line = f"- {req.number}"
        if req.name:
            line += f": {req.name}"
        req_lines.append(line)
    # 拼接所有内容，用换行分隔
    return '\n'.join([summary] + req_lines)

模板中使用： #

{% load requirements_tags %}
{% render_requirements_summary foo %}

这种方式不仅让模板极度简洁，逻辑也更易维护和调试，适合复杂的TXT生成场景。

方案三：利用字符串格式化变量（适合简单场景） #

如果逻辑不算太复杂，可以在视图层把需要输出的内容预先格式化成带换行的字符串，直接传递给模板输出。比如在视图中：

def some_view(request):
    foo = get_object_or_404(Foo, pk=1)
    condition_char = 'x' if foo.condition else ' '
    summary_line = f"[{condition_char}] List of requirements fulfilled: {foo.requirements_fullfilled} of {foo.num_requirements}"
    req_lines = [f"- {req.number}{': ' + req.name if req.name else ''}" for req in foo.requirement]
    txt_content = '\n'.join([summary_line] + req_lines)
    return render(request, 'txt_template.txt', {'txt_content': txt_content})

模板中直接输出：

{{ txt_content }}

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