API · Pandas
Pandas Series.tolist() 函数
Series.tolist() 会将 Series 中的值作为 Python 列表返回。
本页内容
Series.tolist() 会将 pandas Series 中的值作为 Python 列表返回。调用时不需要传入参数:series.tolist()。当你需要将这些值传给要求普通列表的代码,或想在不受 Series 显示格式影响的情况下查看这些值时,这个方法很实用。
将 Series 转换为列表
在 Series 对象上调用此方法,并保存返回值。调用不会修改原始 Series:
values = series.tolist()
此方法不接受参数。它会返回一个 Python list,其中包含按原有顺序排列的 Series 值。返回的列表是独立容器,因此修改列表不会改变 Series。值本身仍遵循通常的 Python 行为;如果值是可变对象,两个容器仍可能引用同一对象。
了解返回的列表
Series 包含比列表更多的结构信息。索引标签和 dtype 描述的是 Series,而 tolist() 只返回值。结果中不会包含作为列表项的索引标签,Python 列表也没有 pandas dtype。如果还需要索引标签,请使用单独的操作获取;如果后续代码依赖索引或 pandas 特有的行为,则应保留 Series。
列表长度与 Series 中的值数量相同,其中也包括表示缺失数据的值。列表中的值保持 Series 原有顺序。创建 Series 时,pandas 可能会为它选择一种 dtype,因此数值可能在转换前就已被强制转换类型;tolist() 返回的是该 Series 当前保存的值,不会还原输入时的原始类型。
转换数值和字符串 Series
运行以下示例:
本节中的代码以及显示的标签或输出仍为英文。
import pandas as pd
scores = pd.Series([88, 91, 76], index=["Mia", "Noah", "Ava"])
names = pd.Series(["Rose", "Jasmine", "Tulip"])
score_list = scores.tolist()
name_list = names.tolist()
print(score_list)
print(name_list)
print(isinstance(score_list, list))
print(score_list == [88, 91, 76])
[88, 91, 76]
['Rose', 'Jasmine', 'Tulip']
True
True
两个调用都使用同一个无参数方法。数值 Series 带有索引标签,但转换得到的列表只包含值。字符串 Series 则会按原有顺序生成字符串列表。
在 Python 中检查结果
如果后续代码需要列表,可以使用 isinstance(result, list) 检查类型;如果要检查内容,则将 result 与预期值比较。示例同时进行了这两项检查:类型检查确认容器类型,相等性检查确认数值及其顺序。你也可以对 name_list 使用相同的检查,例如将它与 ['Rose', 'Jasmine', 'Tulip'] 比较。
如果结果与预期不同,可以在转换前使用 print(series) 检查 Series,并查看它的索引和 dtype。这样有助于判断值是否在创建 Series 时就已发生变化,或变化是否发生在转换过程中。快速转换时,核心调用仍然是 Series.tolist();需要验证结果或将其传给其他函数时,再保存返回值。