如何解决Python双列表同步打乱时的ValueError: not enough values to unpack报错

触发这个解包报错的原因分为两层，只要命中任意一层都会抛出对应的ValueError：

• 最直接的触发场景：self.image_file_list 或 self.label_file_list 本身是空列表
  此时执行combined = list(zip(self.image_file_list, self.label_file_list))会得到长度为0的空列表。后续调用zip(*combined)本质等价于无参调用zip()，这个操作会返回一个不包含任何元素的空迭代器，解包时无法拆出预期的2个返回值，直接抛出“not enough values to unpack (expected 2, got 0)”的错误。
• 隐藏的设计缺陷：就算两个原始列表非空，原方法的返回值设计也存在隐患
  Python 3中zip()返回的是一次性消费的迭代器，非空场景下虽然单次解包不会报错，但后续如果需要复用打乱后的列表内容，很容易出现迭代器耗尽取不到值的问题；同时原逻辑没有对两个列表长度不一致的情况做校验，zip会自动按最短列表截断，极易出现图片和标签错配的问题。

调整shuffle_image_label_lists_together方法的实现，提前做边界校验，修正返回值类型，从根源上避免空解包、错配问题：

1. 增加前置校验逻辑，遇到空列表、长度不匹配的情况时抛出可读的明确错误，不要等模糊的解包报错出现再排查
2. 把打乱后的结果显式转换为列表类型返回，不要直接返回zip迭代器，避免迭代器空值、耗尽的问题

修正后的方法实现：

import random

def shuffle_image_label_lists_together(self):
    # 前置边界校验
    if not self.image_file_list:
        raise ValueError("图片文件列表为空，请检查训练图片路径是否正确、对应目录下是否存在png文件")
    if not self.label_file_list:
        raise ValueError("标签文件列表为空，请检查训练标签路径是否正确、对应目录下是否存在png文件")
    if len(self.image_file_list) != len(self.label_file_list):
        raise ValueError(
            f"图片列表长度({len(self.image_file_list)})与标签列表长度({len(self.label_file_list)})不一致，无法完成同步打乱"
        )
    
    # 同步打乱逻辑
    combined = list(zip(self.image_file_list, self.label_file_list))
    random.shuffle(combined)
    shuffled_image_list, shuffled_label_list = zip(*combined)
    # 显式转为列表返回，而非返回zip迭代器
    return list(shuffled_image_list), list(shuffled_label_list)

调用侧的赋值逻辑可以简化为直接整体赋值，不需要额外做切片替换：

self.image_file_list, self.label_file_list = self.shuffle_image_label_lists_together()

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