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