
在 flask 中使用 `render_template_string` 生成 html 时,常误以为在 python 字符串中添加 `\n` 就能在浏览器查看源代码时看到换行——但实际结果往往是所有 html 被压缩为单行。这是因为:① jinja2 模板引擎默认对表达式输出进行 html 转义,而 `\n` 在 html 中本身不具换行渲染效果;② 更关键的是,**python 层面的 `\n` 拼接发生在模板渲染之前,此时它只是普通字符串的一部分,并不会被 jinja2 当作“可输出的换行内容”处理**;③ 即使传入了 `\n`,若未在模板上下文中显式输出,它会被丢弃或忽略。
要让换行符真实出现在最终 HTML 源码中(例如便于调试、提升可读性或满足某些静态分析工具要求),必须在 Jinja2 模板内部通过 {{ '\n' }} 输出。Jinja2 会将其作为原始文本插入,且默认不转义(除非启用了 autoescape 且该字符串被标记为非安全,但字面量字符串 '\n' 默认视为安全)。
✅ 正确写法示例:
from flask import Flask, render_template_string
app = Flask(__name__)
@app.route('/')
def index():
text = "Hello, World!"
# ✅ 在模板字符串中使用 {{ '\n' }} 插入换行
html = render_template_string('''
{{ text }}
{{ '\n' }}
{{ '\n' }}
''', text=text)
return html⚠️ 注意事项:
- 不要依赖 Python 字符串拼接 \n(如 '
...
' + '\n'),这仅影响 Python 端字符串对象,无法控制 Jinja2 渲染后输出的 HTML 格式; - 若需多行缩进,可重复使用 {{ '\n' }} 或结合 Jinja2 的 whitespace control(如 {%-, -%})精细控制空白;
- 浏览器渲染 HTML 时,源码中的换行不影响页面布局(HTML 会折叠空白符),但对开发者查看源码、自动化解析或 SEO 工具友好;
- 如需在
或
中显示真实换行,请配合 CSS white-space: pre-line 或使用 |safe 过滤器(当内容含 HTML 标签时需谨慎)。
总结:Flask 无全局等价于 PHP 的 PHP_EOL 常量,但 Jinja2 模板内 {{ '\n' }} 就是标准、可靠且语义清晰的换行方案——它把换行逻辑交还给模板层,符合 Flask + Jinja2 的设计范式。










