在 Excel 中设置下拉列表是规范数据录入的常用手段。手动操作虽然简单，但当需要为多个文件或大量单元格批量添加时，用 Python 自动化会更高效。Free Spire.XLS for Python 提供了两种直接的方式：一是通过 Values 属性直接指定选项列表，二是通过 DataRange 属性引用工作表中的单元格区域。
环境准备
安装免费库：
pip install spire.xls.free
代码中需要导入 spire.xls 和 spire.xls.common：
from spire.xls import *
from spire.xls.common import *
核心对象：DataValidation
在 Free Spire.XLS 中，下拉列表本质上是一种“列表类型”的数据验证。每个单元格区域（CellRange）都有一个 DataValidation 属性，通过配置这个对象即可实现下拉列表。最常用的两个设置项是：
DataValidation.DataRange：将某个单元格区域作为选项来源。DataValidation.Values：直接用一个字符串列表作为选项。
设置完成后，目标区域中的每个单元格都会出现下拉箭头，用户只能从预设选项中选择（或根据错误提示设置决定是否允许手动输入）。
下面分别介绍这两种方式。
方法一：直接设置选项值
如果选项固定且数量不多，可以直接在代码中列出，无需在工作表中占用额外区域。这种方式生成的文件更简洁，选项配置完全由代码控制。
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
sheet.Name = "员工信息"
# 写入表头
sheet.Range["A1"].Text = "姓名"
sheet.Range["C1"].Text = "职位"
# 目标单元格区域：C2 到 C10
cellRange = sheet.Range["C2:C10"]
# 直接设置下拉列表的选项值（中文）
cellRange.DataValidation.Values = ["实习生", "技术员", "主管", "总监"]
workbook.SaveToFile("职位下拉列表.xlsx", FileFormat.Version2016)
workbook.Dispose()
Values 接受一个 Python 字符串列表，库会自动将其转换为 Excel 的列表验证。
方法二：引用单元格区域
这种方式适合选项较多、需要动态维护的场景。选项数据存放在工作表的某个区域，目标单元格引用该区域。修改选项时只需编辑数据区域，无需改动代码。
我们创建一个新的工作簿，在 F 列写入部门选项，然后在 B2:B10 区域创建下拉列表引用这些选项。
from spire.xls import *
from spire.xls.common import *
# 创建工作簿并加载文件
workbook = Workbook()
workbook.LoadFromFile("Sample.xlsx")
# 获取第一个工作表
sheet = workbook.Worksheets.get_Item(0)
# 选定需要设置下拉列表的单元格范围
cellRange = sheet.Range["C3:C7"]
# 将数据验证的数据范围设置为 F4:H4
cellRange.DataValidation.DataRange = sheet.Range["F4:H4"]
# 保存文件
workbook.SaveToFile("output/DropDownListExcel.xlsx", FileFormat.Version2016)
workbook.Dispose()
DataRange 接受一个 CellRange 对象，指向包含选项的单元格区域。被引用的区域可以是同一工作表，也可以是同一工作簿中的其他工作表（例如将选项集中放在一个“数据源”表中）。需要注意的是，引用的区域最好是一行或一列，避免多行多列造成选项读取顺序不符合预期。
跨工作表引用：
如果选项数据在另一个工作表中，只需把 sheet.Range["F1:H4"] 换成对应工作表的范围。例如：
data_sheet = workbook.Worksheets[1] # 第二个工作表
data_sheet.Name = "数据源"
data_sheet.Range["A1"].Text = "人事部"
# ... 其他选项
cellRange.DataValidation.DataRange = data_sheet.Range["A1:A10"]
两种方法的对比与选择
| 对比项 | 引用单元格区域 | 直接指定选项值 |
|---|---|---|
| 选项维护 | 在 Excel 中编辑，非技术人员也能修改 | 修改代码，重新生成 |
| 工作表整洁度 | 需要额外的数据区域 | 不占用单元格 |
| 选项数量限制 | 基本无限制（受 Excel 行数限制） | 总字符数不超过 255 |
| 适用场景 | 选项经常变动、数量较多 | 选项固定、数量较少 |
实际使用时可以根据需求灵活选择。如果是一次性生成或选项极少，方式一更直接；如果模板需要交给业务人员长期维护，推荐方式二。
进阶：错误提示与输入提示
数据验证不仅能限制输入，还能在用户操作时给出中文引导。设置完 DataRange 或 Values 后，可以继续配置以下属性：
# 错误提示：用户输入了不在列表中的内容时触发
cellRange.DataValidation.ShowError = True
cellRange.DataValidation.ErrorTitle = "输入无效"
cellRange.DataValidation.ErrorMessage = "请从下拉列表中选择，不要手动输入。"
# 输入提示：单元格被选中时显示
cellRange.DataValidation.ShowInput = True
cellRange.DataValidation.InputTitle = "请选择"
cellRange.DataValidation.InputMessage = "从下拉列表中选择一个选项。"
ShowError为True时，无效输入会弹出错误对话框。AlertStyle可以设置为Stop（阻止输入）、Warning或Information（仅提示但允许继续）。ShowInput为True时，用户点击单元格会看到输入提示，可以在输入前就给出指导。