如何在不修改数据的前提下自动格式化Pandas DataFrame输出？

需求背景 #

希望在Jupyter Notebook中打印DataFrame时（无论是用print函数还是直接运行单元格），特定列自动套用指定格式，同时不修改原始数据的类型（避免影响后续数据运算）。

示例DataFrame：

import pandas as pd
df = pd.DataFrame({"Price": [1234.5, 3456.789], "Increase": [0.01234, 0.23456]})

目标效果：Price列自动显示为${:,.2f}货币格式，Increase列自动显示为{:,.2%}百分比格式。

现有方法的问题 #

• 使用map处理列：会将数值类型转为字符串（object类型），导致后续无法进行数值运算；
• 使用df.style.format()：能实现格式化输出，但每次打印都需要重复调用该方法，操作繁琐。

解决方案 #

方法1：自定义DataFrame子类（全局复用）

通过继承pd.DataFrame，重写输出相关方法，让默认输出自动套用格式化规则，同时保留原始数据类型。

import pandas as pd

class FormattedDataFrame(pd.DataFrame):
    def __init__(self, *args, formatters=None, **kwargs):
        super().__init__(*args, **kwargs)
        self.formatters = formatters or {}
    
    def __repr__(self):
        # 适配文本格式输出
        return self.style.format(self.formatters).to_string()
    
    def _repr_html_(self):
        # 适配Jupyter Notebook的HTML输出
        return self.style.format(self.formatters).render()

# 使用示例
df = FormattedDataFrame(
    {"Price": [1234.5, 3456.789], "Increase": [0.01234, 0.23456]},
    formatters={"Price": "${:,.2f}", "Increase": "{:,.2%}"}
)

此后直接运行df或print(df)，都会自动应用指定格式，且Price和Increase列仍为float64类型，不影响后续运算。

方法2：修改单个DataFrame实例的输出行为

如果不需要全局复用，可直接给现有DataFrame实例重写输出方法，仅对当前实例生效：

import pandas as pd

df = pd.DataFrame({"Price": [1234.5, 3456.789], "Increase": [0.01234, 0.23456]})
formatters = {"Price": "${:,.2f}", "Increase": "{:,.2%}"}

# 保存原始输出方法
original_repr = df.__repr__
original_repr_html = df._repr_html_

# 自定义输出逻辑
def custom_repr():
    return df.style.format(formatters).to_string()

def custom_repr_html():
    return df.style.format(formatters).render()

# 替换实例的输出方法
df.__repr__ = custom_repr
df._repr_html_ = custom_repr_html

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