从 Pandas DataFrame 列标题中获取列表

Question

我想从 Pandas DataFrame 中获取列标题列表。 DataFrame 将来自用户输入，所以我不知道会有多少列或它们将被调用什么。

例如，如果给我一个这样的 DataFrame：

>>> my_dataframe
    y  gdp  cap
0   1    2    5
1   2    3    9
2   8    7    2
3   3    4    7
4   6    7    7
5   4    8    3
6   8    2    8
7   9    9   10
8   6    6    4
9  10   10    7

我会得到一个这样的列表：

>>> header_list
['y', 'gdp', 'cap']

Answer 1

可以通过 my_dataframe.columns 获得。

Answer 2

您可以通过以下方式将值作为列表获取：

list(my_dataframe.columns.values)

你也可以简单地使用（如Ed Chum's answer所示）：

list(my_dataframe)

Answer 3

n = []
for i in my_dataframe.columns:
    n.append(i)
print n

Answer 4

有一个内置方法是性能最高的：

my_dataframe.columns.values.tolist()

.columns 返回一个 Index，.columns.values 返回一个数组，这有一个辅助函数 .tolist 返回一个列表。

如果性能对您来说不那么重要，Index 对象定义了一个您可以直接调用的 .tolist() 方法：

my_dataframe.columns.tolist()

性能上的区别很明显：

%timeit df.columns.tolist()
16.7 µs ± 317 ns per loop (mean ± std. dev. of 7 runs, 100000 loops each)

%timeit df.columns.values.tolist()
1.24 µs ± 12.3 ns per loop (mean ± std. dev. of 7 runs, 1000000 loops each)

---

对于那些讨厌打字的人，您可以在df上拨打list，如下所示：

list(df)

Answer 5

DataFrame 遵循类似于 dict 的惯例，即迭代对象的“键”。

my_dataframe.keys()

创建键/列列表 - 对象方法 to_list() 和 Pythonic 方式：

my_dataframe.keys().to_list()
list(my_dataframe.keys())

DataFrame 上的Basic iteration 返回列标签：

[column for column in my_dataframe]

不要将 DataFrame 转换为列表，只是为了获取列标签。在寻找方便的代码示例时不要停止思考。

xlarge = pd.DataFrame(np.arange(100000000).reshape(10000,10000))
list(xlarge) # Compute time and memory consumption depend on dataframe size - O(N)
list(xlarge.keys()) # Constant time operation - O(1)

Answer 6

我做了一些快速测试，不出所料，使用dataframe.columns.values.tolist() 的内置版本最快：

In [1]: %timeit [column for column in df]
1000 loops, best of 3: 81.6 µs per loop

In [2]: %timeit df.columns.values.tolist()
10000 loops, best of 3: 16.1 µs per loop

In [3]: %timeit list(df)
10000 loops, best of 3: 44.9 µs per loop

In [4]: % timeit list(df.columns.values)
10000 loops, best of 3: 38.4 µs per loop

（不过我还是很喜欢list(dataframe)，所以thanks EdChum！）

Answer 7

它变得更加简单（通过 Pandas 0.16.0）：

df.columns.tolist()

会在一个不错的列表中为您提供列名。

Answer 8

>>> list(my_dataframe)
['y', 'gdp', 'cap']

要在调试器模式下列出数据框的列，请使用列表推导：

>>> [c for c in my_dataframe]
['y', 'gdp', 'cap']

顺便说一句，你可以简单地使用sorted得到一个排序列表：

>>> sorted(my_dataframe)
['cap', 'gdp', 'y']

Answer 9

挺有意思的，不过df.columns.values.tolist()的速度几乎是df.columns.tolist()的三倍，但我以为它们是一样的：

In [97]: %timeit df.columns.values.tolist()
100000 loops, best of 3: 2.97 µs per loop

In [98]: %timeit df.columns.tolist()
10000 loops, best of 3: 9.67 µs per loop

Answer 10

在笔记本中

对于IPython notebook 中的数据探索，我首选的方式是：

sorted(df)

这将产生一个易于阅读的按字母顺序排列的列表。

在代码库中

在代码中我发现这样做更明确

df.columns

因为它告诉其他阅读你的代码的人你在做什么。

Answer 11

我觉得这个问题值得进一步解释。

作为fixxxer noted，答案取决于您在项目中使用的 Pandas 版本。您可以使用pd.__version__ 命令获得。

如果您出于某种原因像我一样（在 Debian 8 (Jessie) 我使用 0.14.1）使用比 0.16.0 更旧的 Pandas 版本，那么您需要使用：

df.keys().tolist() 因为还没有实现任何df.columns 方法。

这种keys方法的优点是它甚至可以在更新版本的Pandas中使用，所以它更通用。

Answer 12

作为answered by Simeon Visser，你可以这样做

list(my_dataframe.columns.values)

或

list(my_dataframe) # For less typing.

但我认为最甜蜜的地方是：

list(my_dataframe.columns)

它是明确的，同时又不是不必要的长。

Answer 13

如需快速、整洁、直观的检查，请尝试以下操作：

for col in df.columns:
    print col

Answer 14

即使之前提供的解决方案很好，我也希望像 frame.column_names() 这样的东西在 Pandas 中成为一个函数，但既然不是，也许使用以下语法会很好。通过调用“tolist”函数，它以某种方式保留了您以正确方式使用 pandas 的感觉：frame.columns.tolist()

frame.columns.tolist()

Answer 15

扩展的可迭代解包（Python 3.5+）：[*df] 和朋友

Unpacking generalizations (PEP 448) 已在 Python 3.5 中引入。所以，下面的操作都是可以的。

df = pd.DataFrame('x', columns=['A', 'B', 'C'], index=range(5))
df

   A  B  C
0  x  x  x
1  x  x  x
2  x  x  x
3  x  x  x
4  x  x  x

如果你想要list....

[*df]
# ['A', 'B', 'C']

或者，如果你想要set，

{*df}
# {'A', 'B', 'C'}

或者，如果你想要tuple，

*df,  # Please note the trailing comma
# ('A', 'B', 'C')

或者，如果您想将结果存储在某处，

*cols, = df  # A wild comma appears, again
cols
# ['A', 'B', 'C']

...如果您是那种将咖啡转换为打字声音的人，那么这会更有效地消耗您的咖啡；）

P.S.：如果性能很重要，你会想要放弃 上面的解决方案有利于

df.columns.to_numpy().tolist()
# ['A', 'B', 'C']

这类似于Ed Chum's answer，但更新为 v0.24 其中.to_numpy() 优于.values。看 this answer（由我）了解更多信息。

目视检查

由于我在其他答案中看到了这一点，因此您可以使用可迭代解包（无需显式循环）。

print(*df)
A B C

print(*df, sep='\n')
A
B
C

---

对其他方法的批判

对于可以在一行中完成的操作，不要使用显式的 for 循环（list comprehensions 可以）。

接下来，使用sorted(df) 不会保留列的原始顺序。为此，您应该改用list(df)。

接下来，list(df.columns) 和 list(df.columns.values) 是糟糕的建议（截至当前版本，v0.24）。 Index（从 df.columns 返回）和 NumPy 数组（从 df.columns.values 返回）都定义了更快、更惯用的 .tolist() 方法。

最后，列表化（即list(df)）只能作为上述 Python 3.4 或更早版本的方法的简洁替代方法，在扩展解包不可用的情况下。

Answer 16

%%timeit
final_df.columns.values.tolist()
948 ns ± 19.2 ns per loop (mean ± std. dev. of 7 runs, 1000000 loops each)

%%timeit
list(final_df.columns)
14.2 µs ± 79.1 ns per loop (mean ± std. dev. of 7 runs, 100000 loops each)

%%timeit
list(final_df.columns.values)
1.88 µs ± 11.7 ns per loop (mean ± std. dev. of 7 runs, 1000000 loops each)

%%timeit
final_df.columns.tolist()
12.3 µs ± 27.4 ns per loop (mean ± std. dev. of 7 runs, 100000 loops each)

%%timeit
list(final_df.head(1).columns)
163 µs ± 20.6 µs per loop (mean ± std. dev. of 7 runs, 10000 loops each)

Answer 17

如果 DataFrame 恰好有一个 Index 或 MultiIndex 并且您希望它们也包含在列名中：

names = list(filter(None, df.index.names + df.columns.values.tolist()))

它避免了调用 reset_index() 对这样一个简单的操作有不必要的性能影响。

我经常需要这个，因为我正在从数据库中传输数据，其中数据帧索引映射到主键/唯一键，但实际上对我来说只是另一个“列”。对于 pandas 来说，为这样的事情提供一个内置方法可能是有意义的（我完全有可能错过了它）。

Answer 18

listHeaders = [colName for colName in my_dataframe]