pandas.DataFrame.insert

DataFrame.insert(loc, column, value, allow_duplicates=<no_default>)

在指定位置将列插入到 DataFrame 中。

如果在 DataFrame 中已经包含 column，则会引发 ValueError，除非将 allow_duplicates 设置为 True。

参数:

locint

插入索引。必须验证 0 <= loc <= len(columns)。

列字符串、数字或可哈希对象

插入列的标签。

值标量、序列或类数组

插入列的内容。

allow_duplicatesbool, 可选, 默认 lib.no_default

允许创建重复的列标签。

参见

Index.insert

通过索引插入新项目。

示例

>>> df = pd.DataFrame({"col1": [1, 2], "col2": [3, 4]})
>>> df
   col1  col2
0     1     3
1     2     4
>>> df.insert(1, "newcol", [99, 99])
>>> df
   col1  newcol  col2
0     1      99     3
1     2      99     4
>>> df.insert(0, "col1", [100, 100], allow_duplicates=True)
>>> df
   col1  col1  newcol  col2
0   100     1      99     3
1   100     2      99     4

请注意，在类型为 Series 的 value 情况下，pandas 使用索引对齐：

>>> df.insert(0, "col0", pd.Series([5, 6], index=[1, 2]))
>>> df
   col0  col1  col1  newcol  col2
0   NaN   100     1      99     3
1   5.0   100     2      99     4