使用for循环遍历Pandas DataFrame出现「值过多无法解包」错误排查

嘿，我来帮你理清楚这个问题～你遇到的「值过多无法解包」错误，核心原因是你忽略了itertuples()方法的默认行为：它会把行索引作为元组的第一个元素返回。

为什么会报错？ #

哪怕你的DataFrame只有1行2列，itertuples()返回的每一行元组结构其实是：(索引值, 列1值, 列2值)，总共3个元素。但你尝试用两个变量去接收这3个值，自然会触发“值过多无法解包”的错误。

你可以看看自己打印的row内容，应该能看到类似这样的输出：

Pandas(Index=0, 列名1=xxx, 列名2=yyy)
或者普通元组形式：(0, xxx, yyy)

这里的0就是行索引，正是它多出来的元素导致了解包失败。

两种解决方案 #

方案1：不返回索引（推荐，如果你不需要索引的话）

给itertuples()加上index=False参数，这样返回的元组就只包含列值，刚好和你的两个循环变量匹配：

for val1, val2 in process_list.itertuples(index=False):
    # 在这里处理val1和val2
    print(val1, val2)

方案2：接收索引（如果需要用到索引的话）

如果你的逻辑里需要用到行索引，那就直接增加一个变量来接收索引值：

for idx, val1, val2 in process_list.itertuples():
    # idx就是行索引，val1、val2是列值
    print(idx, val1, val2)

举个实际例子验证 #

import pandas as pd

# 模拟你的1行2列DataFrame
process_list = pd.DataFrame({'col_a': [100], 'col_b': [200]})

# 错误写法（会报错）
# for a, b in process_list.itertuples():
#     print(a, b)

# 正确写法1：不返回索引
print("不返回索引的情况：")
for a, b in process_list.itertuples(index=False):
    print(a, b)  # 输出：100 200

# 正确写法2：接收索引
print("\n接收索引的情况：")
for idx, a, b in process_list.itertuples():
    print(idx, a, b)  # 输出：0 100 200

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