如何让pd.DataFrame单元格中的列表以标准Python列表格式打印？

问题场景 #

执行以下代码：

print(pd.DataFrame({'a': [['x', 'y']]}))

输出结果为：

a
0  [x, y]

尽管DataFrame单元格中实际存储的是列表，但打印时显示为[x, y]而非['x', 'y']，甚至调用repr()也无法改变这一显示结果。需要让pandas将列表值打印为带引号的格式：

a
0  ["x", "y"]

实现方法 #

方法1：自定义格式化函数处理目标列 #

通过apply方法对存储列表的列做格式化处理：

import pandas as pd

def format_list_with_quotes(lst):
    return f'["{"", ".join(lst)}"]'

df = pd.DataFrame({'a': [['x', 'y'], ['a', 'b', 'c']]})
# 格式化后转为DataFrame打印
print(df['a'].apply(format_list_with_quotes).to_frame())

输出结果：

a
0      ["x", "y"]
1  ["a", "b", "c"]

方法2：全局修改列表的显示格式 #

如果希望所有列表类型的单元格都按标准可逆转格式显示，可以覆盖pandas默认的格式化逻辑：

import pandas as pd
from pandas.io.formats import format as fmt

def format_list_repr(val):
    if isinstance(val, list):
        return repr(val)
    return val

# 替换默认的单元格值格式化逻辑
fmt.DataFrameFormatter.format_value = lambda self, val: format_list_repr(val)

df = pd.DataFrame({'a': [['x', 'y']], 'b': [['1', '2']]})
print(df)

输出结果：

a          b
0  ['x', 'y']  ['1', '2']

显示差异的原因 #

pandas在设计DataFrame打印逻辑时，优先考虑输出的简洁可读性，对列表这类非标量值采用了自定义的简化格式化方式，没有直接调用Python原生的repr()方法输出完整的可逆转字符串。

而Python的repr()约定是让输出尽可能接近可执行代码，即通过ast.literal_eval(repr(x))能还原原对象，但pandas为了紧凑显示牺牲了这一约定，导致调试时容易误判单元格存储类型，增加了排查成本。

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