Flask 中在 Jinja2 模板中正确输出换行符( )的方法

Flask 中在 Jinja2 模板中正确输出换行符( )的方法

在 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 的设计范式。