更新Pandas DataFrame字段时触发ValueError：设置可迭代对象需键值等长

错误原因 #

你的keys列默认存储单个数值（标量类型），执行df.loc[0, 'keys'] = [540, 12]时，你试图给单个单元格（第0行的keys列）赋值一个长度为2的列表。Pandas会将这个可迭代对象（列表）理解为要给多个列赋值，但你只指定了keys这一列，维度不匹配，因此抛出该错误。

解决办法 #

根据实际需求，有两种处理方式：

1. 让keys列存储列表（转为object类型）

如果需要在单个单元格中存储列表数据，直接赋值即可（首次赋值时Pandas会自动将列类型转为object）：

# 直接赋值，列类型自动转为object
df.loc[0, 'keys'] = [540, 12]
# 或用at方法精准操作单个单元格
df.at[0, 'keys'] = [540, 12]

此时keys列的元素可以是单个数值或列表，类型统一为object。

2. 给多个列/多行赋值

如果真实需求是将列表元素分配给不同列，或给多行的keys列赋值，需调整目标范围：

• 给多个列赋值：确保列数量与列表长度一致

  # 新增keys1、keys2列，将列表元素分别赋值给第0行的这两列
  df.loc[0, ['keys1', 'keys2']] = [540, 12]
  

• 给多行的keys列赋值：确保选中行数与列表长度一致

  # 修改第0、1行的keys值，列表长度与选中行数匹配
  df.loc[0:1, 'keys'] = [540, 12]
  

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