Python在Excel工作表添加数据验证的示例代码

更新时间：2026年05月01日 07:12:36 作者：用户835629078051

在处理电子表格数据时,确保输入数据的准确性和一致性至关重要,本文将介绍如何使用 Python 在 Excel 工作表中添加各种类型的数据验证规则,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下

在处理电子表格数据时，确保输入数据的准确性和一致性至关重要。数据验证功能允许开发者设置规则来限制用户可以在单元格中输入的内容，从而防止错误数据的录入。本文将介绍如何使用 Python 在 Excel 工作表中添加各种类型的数据验证规则。

为什么需要数据验证

数据验证在实际应用中具有多种用途：

确保数据质量：限制输入范围，避免无效数据
提高用户体验：提供清晰的错误提示和指导
简化数据处理：减少后续数据清洗的工作量
自动化表单控制：创建标准化的数据录入模板

常见的验证场景包括数字范围限制、日期有效性检查、文本长度控制等。

环境准备

首先需要安装 Spire.XLS for Python 库：

pip install Spire.XLS

该库提供了完整的 Excel 文件操作 API，支持创建、修改和格式化 Excel 文档。

基本实现步骤

添加数据验证的核心流程包括：

加载或创建 Excel 工作簿
获取目标工作表
指定需要应用验证的单元格范围
配置验证规则（类型、条件、错误消息）
保存文件

下面将通过具体示例展示如何实现不同类型的数据验证。

添加数值范围验证

数值验证是最常见的验证类型，可以限制用户只能输入特定范围内的数字。以下代码演示如何设置一个介于 3 到 6 之间的十进制数验证：

from spire.xls import *
from spire.xls.common import *
# 创建工作簿对象
workbook = Workbook()
sheet = workbook.Worksheets[0]
# 添加说明标签
sheet.Range["B11"].Text = "输入数字(3-6):"
# 获取目标单元格范围
rangeNumber = sheet.Range["B12"]
# 设置验证比较运算符为"介于"
rangeNumber.DataValidation.CompareOperator = ValidationComparisonOperator.Between
# 设置最小值和最大值
rangeNumber.DataValidation.Formula1 = "3"
rangeNumber.DataValidation.Formula2 = "6"
# 指定验证类型为十进制数
rangeNumber.DataValidation.AllowType = CellDataType.Decimal
# 设置错误提示信息
rangeNumber.DataValidation.ErrorMessage = "请输入正确的数字！"
# 启用错误提示
rangeNumber.DataValidation.ShowError = True
# 设置单元格背景色以标识验证区域
rangeNumber.Style.KnownColor = ExcelColors.Gray25Percent
# 自动调整列宽
sheet.AutoFitColumn(2)
# 保存文件
workbook.SaveToFile("NumericValidation.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

关键 API 说明：

CompareOperator：定义比较方式，如 Between（介于）、Greater（大于）、Less（小于）等
Formula1 和 Formula2：设置验证条件的边界值
AllowType：指定数据类型，如 Decimal（十进制）、Integer（整数）等
ErrorMessage：当输入无效时显示的错误消息
ShowError：控制是否显示错误对话框

添加日期验证

日期验证确保用户输入的日期在有效范围内。这在处理时间表、截止日期等场景中非常有用：

from spire.xls import *
from spire.xls.common import *

workbook = Workbook()
sheet = workbook.Worksheets[0]

# 添加说明标签
sheet.Range["B14"].Text = "输入日期:"

# 获取目标单元格
rangeDate = sheet.Range["B15"]

# 设置验证类型为日期
rangeDate.DataValidation.AllowType = CellDataType.Date

# 设置比较运算符
rangeDate.DataValidation.CompareOperator = ValidationComparisonOperator.Between

# 设置日期范围（1970年1月1日至1970年12月31日）
rangeDate.DataValidation.Formula1 = "1/1/1970"
rangeDate.DataValidation.Formula2 = "12/31/1970"

# 设置错误消息
rangeDate.DataValidation.ErrorMessage = "请输入正确的日期！"

# 启用错误提示
rangeDate.DataValidation.ShowError = True

# 设置警告样式（可选：Stop、Warning、Information）
rangeDate.DataValidation.AlertStyle = AlertStyleType.Warning

# 设置单元格背景色
rangeDate.Style.KnownColor = ExcelColors.Gray25Percent

sheet.AutoFitColumn(2)

workbook.SaveToFile("DateValidation.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

日期格式可以使用多种标准表示法，如 "MM/DD/YYYY" 或 "YYYY-MM-DD"。AlertStyleType 提供了三种错误提示样式：

Stop：阻止用户输入无效数据
Warning：警告但允许继续
Information：仅提供信息提示

添加文本长度验证

文本长度验证用于控制字符串的最大或最小字符数，适用于用户名、密码、编码等字段：

from spire.xls import *
from spire.xls.common import *

workbook = Workbook()
sheet = workbook.Worksheets[0]

# 添加说明标签
sheet.Range["B17"].Text = "输入文本:"

# 获取目标单元格
rangeTextLength = sheet.Range["B18"]

# 设置验证类型为文本长度
rangeTextLength.DataValidation.AllowType = CellDataType.TextLength

# 设置比较运算符为"小于或等于"
rangeTextLength.DataValidation.CompareOperator = ValidationComparisonOperator.LessOrEqual

# 设置最大长度为5个字符
rangeTextLength.DataValidation.Formula1 = "5"

# 设置错误消息
rangeTextLength.DataValidation.ErrorMessage = "请输入有效的字符串！"

# 启用错误提示
rangeTextLength.DataValidation.ShowError = True

# 设置停止样式，严格阻止无效输入
rangeTextLength.DataValidation.AlertStyle = AlertStyleType.Stop

# 设置单元格背景色
rangeTextLength.Style.KnownColor = ExcelColors.Gray25Percent

sheet.AutoFitColumn(2)

workbook.SaveToFile("TextLengthValidation.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

文本长度验证支持多种比较运算符：

LessOrEqual：小于或等于指定长度
GreaterOrEqual：大于或等于指定长度
Between：在两个长度值之间
Equal：等于指定长度

综合示例：在一个文件中添加多种验证

在实际应用中，通常需要在同一工作表中应用多种验证规则。以下是将上述三种验证整合到一个文件的完整示例：

from spire.xls import *
from spire.xls.common import *

# 创建工作簿
workbook = Workbook()
sheet = workbook.Worksheets[0]

# === 数值验证 ===
sheet.Range["B11"].Text = "输入数字(3-6):"
rangeNumber = sheet.Range["B12"]
rangeNumber.DataValidation.CompareOperator = ValidationComparisonOperator.Between
rangeNumber.DataValidation.Formula1 = "3"
rangeNumber.DataValidation.Formula2 = "6"
rangeNumber.DataValidation.AllowType = CellDataType.Decimal
rangeNumber.DataValidation.ErrorMessage = "请输入正确的数字！"
rangeNumber.DataValidation.ShowError = True
rangeNumber.Style.KnownColor = ExcelColors.Gray25Percent

# === 日期验证 ===
sheet.Range["B14"].Text = "输入日期:"
rangeDate = sheet.Range["B15"]
rangeDate.DataValidation.AllowType = CellDataType.Date
rangeDate.DataValidation.CompareOperator = ValidationComparisonOperator.Between
rangeDate.DataValidation.Formula1 = "1/1/1970"
rangeDate.DataValidation.Formula2 = "12/31/1970"
rangeDate.DataValidation.ErrorMessage = "请输入正确的日期！"
rangeDate.DataValidation.ShowError = True
rangeDate.DataValidation.AlertStyle = AlertStyleType.Warning
rangeDate.Style.KnownColor = ExcelColors.Gray25Percent

# === 文本长度验证 ===
sheet.Range["B17"].Text = "输入文本:"
rangeTextLength = sheet.Range["B18"]
rangeTextLength.DataValidation.AllowType = CellDataType.TextLength
rangeTextLength.DataValidation.CompareOperator = ValidationComparisonOperator.LessOrEqual
rangeTextLength.DataValidation.Formula1 = "5"
rangeTextLength.DataValidation.ErrorMessage = "请输入有效的字符串！"
rangeTextLength.DataValidation.ShowError = True
rangeTextLength.DataValidation.AlertStyle = AlertStyleType.Stop
rangeTextLength.Style.KnownColor = ExcelColors.Gray25Percent

# 自动调整列宽
sheet.AutoFitColumn(2)

# 保存文件
workbook.SaveToFile("DataValidation.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

实用技巧

自定义下拉列表验证

除了上述验证类型，还可以创建下拉列表供用户选择：

# 创建下拉列表验证
rangeList = sheet.Range["C5"]
rangeList.DataValidation.AllowType = CellDataType.List
rangeList.DataValidation.Formula1 = '"选项1,选项2,选项3"'
rangeList.DataValidation.ShowDropDown = True

注意：下拉列表的选项需要使用双引号包裹，并用逗号分隔。

从单元格范围引用验证数据

可以从其他单元格范围动态读取验证数据：

# 从A1:A5范围读取列表数据
rangeDynamic = sheet.Range["D5"]
rangeDynamic.DataValidation.AllowType = CellDataType.List
rangeDynamic.DataValidation.Formula1 = "=A1:A5"

这种方式允许动态更新验证选项，无需修改代码。

清除数据验证

如需移除已设置的验证规则：

# 清除指定单元格的验证
rangeToClear.DataValidation.Clear()

总结

本文介绍了如何使用 Python 在 Excel 中添加数据验证，包括数值范围验证、日期验证和文本长度验证。通过合理配置 DataValidation 对象的属性，可以实现灵活的数据输入控制，提升电子表格的数据质量和用户体验。

这些技术特别适用于：

创建标准化数据录入模板
构建数据收集表单
实施数据质量控制流程
开发自动化报表系统

掌握数据验证技术后，可以结合其他 Excel 操作功能（如条件格式、公式计算等），构建更加完善的自动化办公解决方案。

到此这篇关于Python在Excel工作表添加数据验证的示例代码的文章就介绍到这了,更多相关Python Excel添加数据验证内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Python使用Nocalhost并开启debug调试的方法
Nocalhost是一种开发者工具，支持针对Kubernetes应用程序进行调试和部署，这篇文章主要介绍了Python怎么使用Nocalhost并开启debug,需要的朋友可以参考下
2023-04-04
Python开发游戏自动化后台脚本的实现
本文主要介绍了Python开发游戏自动化后台脚本的实现，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-01-01
Python+wxPython实现一个简单的音乐播放器
这篇文章主要为大家详细介绍了如何使用Python编程语言和wxPython模块创建一个简单的音乐播放器,文中的示例代码讲解详细,感兴趣的可以了解下
2023-09-09
Python稀疏矩阵及参数保存代码实现
这篇文章主要介绍了Python稀疏矩阵及参数保存代码实现,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-04-04
Pycharm中配置使用Anaconda的虚拟环境进行项目开发的图文教程
今天在一台电脑上跑环境的时候,发现已经装了Pytorch了,但是运行没有用,提示报错：OSError: [WinError 126] 找不到指定的模块,但其实cmd进入虚拟环境是可以调用torch的,故本文给大家介绍了Pycharm中配置使用Anaconda的虚拟环境进行项目开发的图文教程
2024-09-09
pygame学习笔记（4）：声音控制
这篇文章主要介绍了pygame学习笔记（4）：声音控制,本文讲解了pygame.mixer启动与初始化、播放声音片段wav文件、播放mp3、wma、ogg音乐文件、控制音量、制作mp3播放器中遇到的问题等内容,需要的朋友可以参考下
2015-04-04
Python开发中最常见的错误大全及解决方法
Python 以简洁易读著称,但即便是经验丰富的开发者,也常被各种错误搞得焦头烂额,本文系统梳理了 Python 中最常见的错误类型,并特别深入解析了 JSON 相关错误——这是 Web 开发、API 调用和数据处理中最频繁出现的问题之一,需要的朋友可以参考下
2025-12-12
pytorch单元测试的实现示例
单元测试是一种软件测试方法,本文主要介绍了pytorch单元测试的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-04-04
Python中while循环常见用法与实战代码
while是Python中的条件循环语句,只要条件为True,就会持续执行循环体,与for不同,while循环更适合于不确定循环次数、需要根据条件退出的场景,这篇文章主要介绍了Python中while循环常见用法与实战代码的相关资料,需要的朋友可以参考下
2026-05-05
python sys，os，time模块的使用（包括时间格式的各种转换）
这篇文章主要介绍了python sys，os，time模块的使用（包括时间格式的各种转换），小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-04-04