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 文本模板工程化输出的标准实践之一。
