使用ydata-profiling与pandas to_html()报错TemplateSyntaxError求助

问题根源 #

pandas 的 to_html() 方法底层依赖 Jinja2 模板引擎渲染输出。而 ydata-profiling 生成的分析结果（比如部分统计描述文本、自动生成的注释字段）中可能包含了 Jinja2 的模板语法标记（如 {{ ... }}、{% ... %}），这些标记会被模板引擎误识别为可执行代码，从而触发「unexpected 'end of statement block'」语法错误。而 to_json() 不会触发模板渲染逻辑，因此可以正常运行。

解决办法 #

1. 直接使用 ydata-profiling 自带的 HTML 导出（推荐） #

ydata-profiling 本身提供了原生的 HTML 报告生成功能，完全不需要借助 pandas 的 to_html()，这是最适配的方案：

from ydata_profiling import ProfileReport

# 生成数据集分析报告
profile_report = ProfileReport(your_dataset, title="数据集分析报告")
# 直接导出为 HTML 文件
profile_report.to_file("profiling_result.html")

2. 转义 DataFrame 中的模板特殊字符 #

如果必须使用 pandas 的 to_html()，需要先将 DataFrame 中含有的模板语法字符转义为 HTML 实体，避免被模板引擎解析：

def escape_template_tokens(value):
    if isinstance(value, str):
        # 将 Jinja2 模板标记转义为 HTML 实体
        value = value.replace("{{", "{{")\
                     .replace("}}", "}}")\
                     .replace("{%", "{%")\
                     .replace("%}", "%}")
    return value

# 对整个 DataFrame 应用转义逻辑
cleaned_df = your_profiling_result_df.applymap(escape_template_tokens)
# 导出为 HTML
cleaned_df.to_html("output.html")

3. 禁用 pandas to_html 的模板渲染（特定版本可用） #

部分 pandas 版本支持通过 template=None 参数跳过模板渲染流程，直接生成基础 HTML：

your_profiling_result_df.to_html("output.html", template=None)

内容的提问来源于stack exchange，提问作者Madushan