Jinja2 模板中，为保持代码可读性常对 {% for %} 等逻辑块添加缩进，但输出时需消除这些缩进；textwrap.dedent() 应用于渲染后结果，而非模板字符串本身，是兼顾可读性与纯净输出的推荐方案。

jinja2 模板中，为保持代码可读性常对 `{% for %}` 等逻辑块添加缩进，但输出时需消除这些缩进；`textwrap.dedent()` 应用于渲染后结果，而非模板字符串本身，是兼顾可读性与纯净输出的推荐方案。

在 Jinja2 开发中，一个常见矛盾是：模板源码需要良好缩进以提升可维护性，但最终生成的文本（如 M3U 播放列表、配置文件、CSV 等纯文本格式）却严格要求无前导空格。直接对模板字符串使用 textwrap.dedent() 仅能处理模板顶层缩进，无法清除 {% for %} 内部内容因缩进而产生的多余空格——这正是问题的核心。

正确解法是：保持模板原生缩进（提升可读性），在 render() 完成后再对输出结果统一去缩进。这样既不牺牲开发体验，又确保输出符合格式规范。

以下为完整实践示例：

import jinja2
import textwrap

M3U_TEMPLATE = jinja2.Template(
    """
        #EXTM3U

        {% for item in playlist %}
            #EXTALB:{{ item.strAlbum }} ({{ item.release }})
            #EXTART:{{ item.strAlbumArtists }}
            #EXTINF:{{ item.iDuration }},{{ item.strArtists }} - {{ item.strTitle }}
            {{ item.path }}
        {% endfor %}
    """
)

# 渲染后立即 dedent，确保每行无前导空格
output = M3U_TEMPLATE.render(
    playlist=[
        {
            "strAlbum": "Offramp", "release": "1982",
            "strAlbumArtists": "Pat Metheny Group",
            "iDuration": 408,
            "strArtists": "Pat Metheny Group",
            "strTitle": "James",
            "path": "/media/Jazz, Fusion etc/Pat Metheny Group/1982 • Offramp/06 James.m4a"
        },
        {
            "strAlbum": "Blue Moon", "release": "1961",
            "strAlbumArtists": "The Marcels",
            "iDuration": 133,
            "strArtists": "The Marcels",
            "strTitle": "Blue Moon",
            "path": "/media/Pop/The Marcels/1961 • Blue Moon/01 Blue Moon.m4a"
        }
    ]
)

print(textwrap.dedent(output).strip())

✅ 输出效果（无任何前导空格，符合 M3U 规范）：

#EXTM3U

#EXTALB:Offramp (1982)
#EXTART:Pat Metheny Group
#EXTINF:408,Pat Metheny Group - James
/media/Jazz, Fusion etc/Pat Metheny Group/1982 • Offramp/06 James.m4a

#EXTALB:Blue Moon (1961)
#EXTART:The Marcels
#EXTINF:133,The Marcels - Blue Moon
/media/Pop/The Marcels/1961 • Blue Moon/01 Blue Moon.m4a

⚠️ 注意事项：

• 不要对模板字符串本身 dedent：否则会破坏 {% for %} 块内换行与缩进逻辑，可能导致语法错误或意外空白；
• textwrap.dedent() 仅移除公共前缀空格，对混合缩进（如空格+Tab）鲁棒性有限，建议模板统一使用空格缩进；
• 若输出中某变量值本身含意外缩进（如 item.strTitle 带换行或前导空格），需在模板中用 |trim 过滤：{{ item.strTitle | trim }}；
• 对于超大规模渲染，dedent 是轻量操作，性能无虞；若需更高定制性（如仅清理特定区块），可结合正则或自定义 Jinja2 过滤器实现。

该方法简洁、可靠，是 Jinja2 文本模板工程化输出的标准实践之一。