向DataFrame添加列表报错：值长度与索引长度不匹配

我之前也碰到过好几次这种“明明列表长度和行数一致却报错”的情况，大概率是索引不匹配在搞鬼！咱们一步步来排查解决：

先明确你的问题场景 #

原始DataFrame：

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

期望结果：

A       B       C
0  1    Blue   Purple
1  2  Yellow   Yellow
2  3   Green   Orange
3  4    Blue    Brown

你尝试的代码：

df1.B = ['Blue', 'Yellow', 'Green', 'Blue']
df1.C = ['Purple', 'Yellow', 'Orange', 'Brown']

却触发报错：ValueError: Length of values does not match length of index

问题根源排查 #

先运行下面的代码，确认你的DataFrame实际状态：

print("DataFrame行数：", df1.shape[0])
print("DataFrame索引：", df1.index.tolist())

大概率会出现两种情况：

1. 行数不是4：说明你以为的4行DataFrame其实有隐藏行（比如之前做过筛选没重置索引）
2. 行数是4，但索引不是[0,1,2,3]：比如索引是[1,2,3,4]或者有重复/非连续索引，这时候Pandas会尝试把列表元素和索引一一对应，而不是按行的位置匹配，就会触发长度不匹配的报错。

解决方案 #

方案一：用.loc/.iloc强制按位置赋值（推荐）

不管索引是什么，直接按行的位置给列赋值：

# 用.loc按列名赋值
df1.loc[:, 'B'] = ['Blue', 'Yellow', 'Green', 'Blue']
df1.loc[:, 'C'] = ['Purple', 'Yellow', 'Orange', 'Brown']

# 或者用.iloc按列的位置赋值（B是第2列，索引为1；C是第3列，索引为2）
df1.iloc[:, 1] = ['Blue', 'Yellow', 'Green', 'Blue']
df1.iloc[:, 2] = ['Purple', 'Yellow', 'Orange', 'Brown']

方案二：重置索引（如果不需要保留原索引）

把DataFrame的索引重置为默认的0-based连续索引，再赋值：

df1 = df1.reset_index(drop=True)
df1['B'] = ['Blue', 'Yellow', 'Green', 'Blue']
df1['C'] = ['Purple', 'Yellow', 'Orange', 'Brown']

验证结果 #

运行完上面的代码后，你可以用print(df1)查看，就能得到你期望的结果啦！

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