openpyxl 的数据验证功能需严格指定类型、运算符及限制值，仅设置 `type='whole'` 而不提供 `operator` 和 `formula1` 将导致验证失效——excel 会静默忽略该规则。
在使用 openpyxl 添加数据验证时，一个常见误区是仅初始化 DataValidation 对象并指定 type（如 'whole'、'list' 或 'decimal'），却忽略了该类型所必需的约束参数。例如，整数验证（type='whole'）必须同时指定 operator（如 'between'、'greaterThan'）和至少一个公式参数（formula1，必要时还需 formula2）。否则，尽管代码无报错、文件可正常保存，Excel 打开后将完全不显示任何验证规则——这是 openpyxl 的设计行为，而非 bug。
以下是正确配置整数范围验证（例如：允许输入 1 到 100 的整数）的完整示例：
import openpyxl
from openpyxl.worksheet.datavalidation import DataValidation
file_path = 'file.xlsx'
sheet_name = 'Sheet1'
workbook = openpyxl.load_workbook(filename=file_path, read_only=False)
ws = workbook[sheet_name]
# ✅ 正确：指定 type、operator 和 formula1（formula2 在 'between' 时必需）
dv = DataValidation(
type="whole",
operator="between",
formula1=1,
formula2=100,
showErrorMessage=True,
errorTitle="输入错误",
error="请输入 1 到 100 之间的整数。"
)
# 添加验证规则到工作表（必须调用 add()）
ws.add_data_validation(dv)
# 绑定到目标单元格（支持单个或区域，如 "A1:C1" 或 ws['A1':'C1']）
target_cells = [ws['A1'], ws['B1'], ws['C1']]
for cell in target_cells:
dv.add(cell)
workbook.save(file_path)⚠️ 关键注意事项：
- formula1 和 formula2 必须为数值、字符串引用（如 '"Apple"'）或单元格地址（如 '$D$1'），不可为 Python 变量名或未加引号的文本；
- 对于下拉列表（type='list'），需用英文逗号分隔的字符串（如 formula1='"苹果,香蕉,橙子"'）或引用含列表的单元格区域（如 formula1='Sheet2!$A$1:$A$3'）；
- showErrorMessage=True 启用自定义错误提示，但需配合 errorTitle 和 error 设置，否则使用默认提示；
- 验证规则添加后，务必调用 ws.add_data_validation(dv)（注册规则）和 dv.add(cell)（绑定单元格），缺一不可；
- Excel 仅在“数据”选项卡 → “数据验证”中可见已生效的规则，若未出现，请检查上述参数完整性。
总结：openpyxl 的数据验证不是“即设即用”，而是强契约式配置——每个 type 都有其隐含的参数契约。查阅 openpyxl 源码中的 DataValidation.__init__ 或官方文档中各 type 对应的 operator 支持表，是避免静默失败的最可靠方式。
