如何在Python Pandas中为DataFrame添加标题下方的头部说明区域并实现预期输出

嘿，我来帮你搞定这个需求！你想要在DataFrame的标题（也就是你设置的Outputs）下面添加一段头部说明文本，对吧？咱们可以通过Pandas的Styler工具结合CSS或HTML调整来实现，下面是两种实用方案：

方案1：用CSS伪元素快速添加简单文本 #

这种方法适合短文本、不需要复杂格式的场景，直接通过CSS的:after伪元素在标题后方追加内容：

import pandas as pd
from IPython.display import display

class SubclassedDataFrame(pd.DataFrame):
    _metadata = ['description']
    @property
    def _constructor(self):
        return SubclassedDataFrame

data = {"a": [1, 2, 3], "b": [10, 12, 13], "c": [230, 1, 3],"d": [8, 12, 9],}
df = SubclassedDataFrame(data)
title = 'Outputs'
header = '这是自定义的头部说明文本'

# 设置标题样式+添加header内容
styled_df = df.style.set_caption(title).set_table_styles([
    # 标题样式配置
    {
        'selector': 'caption',
        'props': [
            ('color', 'red'),
            ('font-size', '15px'),
            ('font-style', 'italic'),
            ('font-weight', 'bold'),
            ('text-align', 'center'),
            ('margin-bottom', '8px')
        ]
    },
    # 在标题下方插入header文本
    {
        'selector': 'caption:after',
        'props': [
            ('content', f'"{header}"'),
            ('display', 'block'),
            ('color', '#333'),
            ('font-size', '12px'),
            ('text-align', 'center'),
            ('font-weight', 'normal'),
            ('font-style', 'normal')
        ]
    }
])

display(styled_df)

小提示：如果header文本包含双引号，记得转义（比如用单引号包裹文本，或者用\\"转义双引号）。

方案2：拼接HTML实现复杂格式的头部说明 #

如果你的header需要更灵活的排版（比如换行、加粗、颜色渐变等），直接修改Styler生成的HTML是更自由的选择：

import pandas as pd
from IPython.display import display, HTML

class SubclassedDataFrame(pd.DataFrame):
    _metadata = ['description']
    @property
    def _constructor(self):
        return SubclassedDataFrame

data = {"a": [1, 2, 3], "b": [10, 12, 13], "c": [230, 1, 3],"d": [8, 12, 9],}
df = SubclassedDataFrame(data)
title = 'Outputs'
# 这里可以写任意HTML格式的内容，完全自定义样式
header = '<p style="text-align:center; color:#666; font-size:13px; margin:5px 0;">这是<b>支持HTML格式</b>的头部说明，还可以<br>换行显示</p>'

# 先生成带标题的基础样式HTML
base_html = df.style.set_caption(title).set_table_styles([
    {
        'selector': 'caption',
        'props': [
            ('color', 'red'),
            ('font-size', '15px'),
            ('font-style', 'italic'),
            ('font-weight', 'bold'),
            ('text-align', 'center'),
            ('margin-bottom', '5px')
        ]
    }
]).to_html()

# 在结束的caption标签后插入自定义header的HTML
final_html = base_html.replace('</caption>', f'</caption>{header}')

# 展示最终效果
display(HTML(final_html))

两种方案都能实现你要的预期效果，根据你的header内容复杂度选择就行啦！

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