为何列表无法作为类参数？Django ChoiceField传参触发ValueError

你遇到的这个错误根源很明确：Django的ChoiceField对choices参数的格式有严格要求——它需要的是由二元组组成的可迭代对象，每个元组的结构是(存储到数据库/表单的值, 前端显示的友好标签)。而你的get_employee_names()返回的是单纯的字符串列表，再加上你错误地用[get_employee_names()]把整个列表包成了一个元素，导致Django尝试去解包这个大列表时，发现元素数量远超过预期的2个，直接触发了报错。

接下来给你两种修正方案，优先推荐第一种动态设置的方式：

方案1：动态在表单初始化时设置Choices（推荐） #

这种方式的好处是每次渲染表单时都会重新读取Excel文件获取最新的员工名单，避免类定义时一次性读取导致数据不更新的问题。

第一步：修改get_employee_names函数，返回二元组列表 #

把原本返回的字符串列表转换成(值, 标签)格式的二元组列表，如果不需要区分存储值和显示标签，可以让两者一致（显示标签做首字母大写处理更友好）：

def get_employee_names():
    tips_file = 'media/reports/Tips_By_Employee_Report.xls'
    df_employee_names = pd.read_excel(
        tips_file, sheet_name=0, header=None, skiprows=7)
    df_employee_names.rename(
        columns={0: 'Employee'}, inplace=True)
    df_employee_names['Employee'] = df_employee_names['Employee'].str.lower()
    employee_names = df_employee_names.loc[:, 'Employee'].tolist()
    # 转换为ChoiceField需要的二元组格式
    return [(name, name.title()) for name in employee_names]

第二步：在表单的__init__方法中动态设置choices #

不要在类定义时直接赋值，而是在初始化表单时更新字段的choices：

from payroll.payroll import get_employee_names
class ManagerForm(forms.Form):
    names = forms.ChoiceField(choices=[])  # 先初始化空的choices

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 动态获取最新的员工名单并设置给字段
        self.fields['names'].choices = get_employee_names()

方案2：直接在类定义时设置Choices（不推荐，数据不会自动更新） #

如果你确定Excel文件不会频繁修改，也可以直接在类定义时赋值，但要注意这种方式只会在服务启动时读取一次文件，后续文件更新需要重启服务才会生效：

from payroll.payroll import get_employee_names
class ManagerForm(forms.Form):
    # 注意不要加外层的[]，直接传入函数返回的二元组列表
    names = forms.ChoiceField(choices=get_employee_names())

为什么原来的代码会报错？ #

你原来写的choices=[get_employee_names()]相当于把整个员工列表当成了Choices里的一个选项，Django尝试把这个大列表解包成(value, label)两个值，自然会报“too many values to unpack”的错误。就算你去掉外层的[]，直接传get_employee_names()返回的字符串列表，Django也会尝试把每个字符串解包成两个值（比如value, label = "john"），同样会触发类似的错误。

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