脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 脚本专栏 → python → Python Excel添加数据验证

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添加数据验证内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • django form和field具体方法和属性说明

    django form和field具体方法和属性说明

    这篇文章主要介绍了django form和field具体方法和属性说明，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
    2020-07-07
  • 用 Python 绘制全国鸿星尔克门店分布图

    用 Python 绘制全国鸿星尔克门店分布图

    这篇文章主要介绍了用 Python 绘制全国鸿星尔克门店分布图，今天就以某度地图 用Python爬虫看一下全国到底有多少家鸿星尔克门店，,需要的朋友可以参考一下
    2022-01-01
  • linux环境下python中MySQLdb模块的安装方法

    linux环境下python中MySQLdb模块的安装方法

    这篇文章主要给大家介绍了在linux环境下python中MySQLdb模块的安装方法，文中给大家介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面来一起看看吧。
    2017-06-06
  • 打包PyQt5应用时的注意事项

    打包PyQt5应用时的注意事项

    这篇文章主要介绍了打包PyQt5应用时的注意事项的相关资料,需要的朋友可以参考下
    2020-02-02
  • Python如何使用标准库tmpfile库创建临时文件

    Python如何使用标准库tmpfile库创建临时文件

    这篇文章主要介绍了Python如何使用标准库tmpfile库创建临时文件问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-02-02
  • Python Tornado之跨域请求与Options请求方式

    Python Tornado之跨域请求与Options请求方式

    这篇文章主要介绍了Python Tornado之跨域请求与Options请求方式，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
    2020-03-03
  • Python如何求取逆序数

    Python如何求取逆序数

    这篇文章主要介绍了Python如何求取逆序数问题，具有很好的参考价值，希望大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2022-12-12
  • Python文件操作基础流程解析

    Python文件操作基础流程解析

    这篇文章主要介绍了Python文件操作基础流程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-03-03
  • Python OpenCV超详细讲解调整大小与图像操作的实现

    Python OpenCV超详细讲解调整大小与图像操作的实现

    OpenCV用C++语言编写，它具有C ++，Python，Java和MATLAB接口，并支持Windows，Linux，Android和Mac OS，OpenCV主要倾向于实时视觉应用，并在可用时利用MMX和SSE指令，本篇文章带你通过OpenCV实现重调大小与图像裁剪
    2022-04-04
  • django框架ModelForm组件用法详解

    django框架ModelForm组件用法详解

    这篇文章主要介绍了django框架ModelForm组件用法,结合实例形式较为详细的分析了Django框架ModelForm组件相关功能、原理、使用方法及操作注意事项,需要的朋友可以参考下
    2019-12-12

最新评论