Python在Excel工作表添加數(shù)據(jù)驗(yàn)證的示例代碼

更新時間：2026年05月01日 07:12:36 作者：用戶835629078051

在處理電子表格數(shù)據(jù)時,確保輸入數(shù)據(jù)的準(zhǔn)確性和一致性至關(guān)重要,本文將介紹如何使用 Python 在 Excel 工作表中添加各種類型的數(shù)據(jù)驗(yàn)證規(guī)則,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以了解下

在處理電子表格數(shù)據(jù)時，確保輸入數(shù)據(jù)的準(zhǔn)確性和一致性至關(guān)重要。數(shù)據(jù)驗(yàn)證功能允許開發(fā)者設(shè)置規(guī)則來限制用戶可以在單元格中輸入的內(nèi)容，從而防止錯誤數(shù)據(jù)的錄入。本文將介紹如何使用 Python 在 Excel 工作表中添加各種類型的數(shù)據(jù)驗(yàn)證規(guī)則。

為什么需要數(shù)據(jù)驗(yàn)證

數(shù)據(jù)驗(yàn)證在實(shí)際應(yīng)用中具有多種用途：

確保數(shù)據(jù)質(zhì)量：限制輸入范圍，避免無效數(shù)據(jù)
提高用戶體驗(yàn)：提供清晰的錯誤提示和指導(dǎo)
簡化數(shù)據(jù)處理：減少后續(xù)數(shù)據(jù)清洗的工作量
自動化表單控制：創(chuàng)建標(biāo)準(zhǔn)化的數(shù)據(jù)錄入模板

常見的驗(yàn)證場景包括數(shù)字范圍限制、日期有效性檢查、文本長度控制等。

環(huán)境準(zhǔn)備

首先需要安裝 Spire.XLS for Python 庫：

pip install Spire.XLS

該庫提供了完整的 Excel 文件操作 API，支持創(chuàng)建、修改和格式化 Excel 文檔。

基本實(shí)現(xiàn)步驟

添加數(shù)據(jù)驗(yàn)證的核心流程包括：

加載或創(chuàng)建 Excel 工作簿
獲取目標(biāo)工作表
指定需要應(yīng)用驗(yàn)證的單元格范圍
配置驗(yàn)證規(guī)則（類型、條件、錯誤消息）
保存文件

下面將通過具體示例展示如何實(shí)現(xiàn)不同類型的數(shù)據(jù)驗(yàn)證。

添加數(shù)值范圍驗(yàn)證

數(shù)值驗(yàn)證是最常見的驗(yàn)證類型，可以限制用戶只能輸入特定范圍內(nèi)的數(shù)字。以下代碼演示如何設(shè)置一個介于 3 到 6 之間的十進(jìn)制數(shù)驗(yàn)證：

from spire.xls import *
from spire.xls.common import *
# 創(chuàng)建工作簿對象
workbook = Workbook()
sheet = workbook.Worksheets[0]
# 添加說明標(biāo)簽
sheet.Range["B11"].Text = "輸入數(shù)字(3-6):"
# 獲取目標(biāo)單元格范圍
rangeNumber = sheet.Range["B12"]
# 設(shè)置驗(yàn)證比較運(yùn)算符為"介于"
rangeNumber.DataValidation.CompareOperator = ValidationComparisonOperator.Between
# 設(shè)置最小值和最大值
rangeNumber.DataValidation.Formula1 = "3"
rangeNumber.DataValidation.Formula2 = "6"
# 指定驗(yàn)證類型為十進(jìn)制數(shù)
rangeNumber.DataValidation.AllowType = CellDataType.Decimal
# 設(shè)置錯誤提示信息
rangeNumber.DataValidation.ErrorMessage = "請輸入正確的數(shù)字！"
# 啟用錯誤提示
rangeNumber.DataValidation.ShowError = True
# 設(shè)置單元格背景色以標(biāo)識驗(yàn)證區(qū)域
rangeNumber.Style.KnownColor = ExcelColors.Gray25Percent
# 自動調(diào)整列寬
sheet.AutoFitColumn(2)
# 保存文件
workbook.SaveToFile("NumericValidation.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

關(guān)鍵 API 說明：

CompareOperator：定義比較方式，如 Between（介于）、Greater（大于）、Less（小于）等
Formula1 和 Formula2：設(shè)置驗(yàn)證條件的邊界值
AllowType：指定數(shù)據(jù)類型，如 Decimal（十進(jìn)制）、Integer（整數(shù)）等
ErrorMessage：當(dāng)輸入無效時顯示的錯誤消息
ShowError：控制是否顯示錯誤對話框

添加日期驗(yàn)證

日期驗(yàn)證確保用戶輸入的日期在有效范圍內(nèi)。這在處理時間表、截止日期等場景中非常有用：

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

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

# 添加說明標(biāo)簽
sheet.Range["B14"].Text = "輸入日期:"

# 獲取目標(biāo)單元格
rangeDate = sheet.Range["B15"]

# 設(shè)置驗(yàn)證類型為日期
rangeDate.DataValidation.AllowType = CellDataType.Date

# 設(shè)置比較運(yùn)算符
rangeDate.DataValidation.CompareOperator = ValidationComparisonOperator.Between

# 設(shè)置日期范圍（1970年1月1日至1970年12月31日）
rangeDate.DataValidation.Formula1 = "1/1/1970"
rangeDate.DataValidation.Formula2 = "12/31/1970"

# 設(shè)置錯誤消息
rangeDate.DataValidation.ErrorMessage = "請輸入正確的日期！"

# 啟用錯誤提示
rangeDate.DataValidation.ShowError = True

# 設(shè)置警告樣式（可選：Stop、Warning、Information）
rangeDate.DataValidation.AlertStyle = AlertStyleType.Warning

# 設(shè)置單元格背景色
rangeDate.Style.KnownColor = ExcelColors.Gray25Percent

sheet.AutoFitColumn(2)

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

日期格式可以使用多種標(biāo)準(zhǔn)表示法，如 "MM/DD/YYYY" 或 "YYYY-MM-DD"。AlertStyleType 提供了三種錯誤提示樣式：

Stop：阻止用戶輸入無效數(shù)據(jù)
Warning：警告但允許繼續(xù)
Information：僅提供信息提示

添加文本長度驗(yàn)證

文本長度驗(yàn)證用于控制字符串的最大或最小字符數(shù)，適用于用戶名、密碼、編碼等字段：

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

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

# 添加說明標(biāo)簽
sheet.Range["B17"].Text = "輸入文本:"

# 獲取目標(biāo)單元格
rangeTextLength = sheet.Range["B18"]

# 設(shè)置驗(yàn)證類型為文本長度
rangeTextLength.DataValidation.AllowType = CellDataType.TextLength

# 設(shè)置比較運(yùn)算符為"小于或等于"
rangeTextLength.DataValidation.CompareOperator = ValidationComparisonOperator.LessOrEqual

# 設(shè)置最大長度為5個字符
rangeTextLength.DataValidation.Formula1 = "5"

# 設(shè)置錯誤消息
rangeTextLength.DataValidation.ErrorMessage = "請輸入有效的字符串！"

# 啟用錯誤提示
rangeTextLength.DataValidation.ShowError = True

# 設(shè)置停止樣式，嚴(yán)格阻止無效輸入
rangeTextLength.DataValidation.AlertStyle = AlertStyleType.Stop

# 設(shè)置單元格背景色
rangeTextLength.Style.KnownColor = ExcelColors.Gray25Percent

sheet.AutoFitColumn(2)

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

文本長度驗(yàn)證支持多種比較運(yùn)算符：

LessOrEqual：小于或等于指定長度
GreaterOrEqual：大于或等于指定長度
Between：在兩個長度值之間
Equal：等于指定長度

綜合示例：在一個文件中添加多種驗(yàn)證

在實(shí)際應(yīng)用中，通常需要在同一工作表中應(yīng)用多種驗(yàn)證規(guī)則。以下是將上述三種驗(yàn)證整合到一個文件的完整示例：

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

# 創(chuàng)建工作簿
workbook = Workbook()
sheet = workbook.Worksheets[0]

# === 數(shù)值驗(yàn)證 ===
sheet.Range["B11"].Text = "輸入數(shù)字(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 = "請輸入正確的數(shù)字！"
rangeNumber.DataValidation.ShowError = True
rangeNumber.Style.KnownColor = ExcelColors.Gray25Percent

# === 日期驗(yàn)證 ===
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

# === 文本長度驗(yàn)證 ===
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

# 自動調(diào)整列寬
sheet.AutoFitColumn(2)

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

實(shí)用技巧

自定義下拉列表驗(yàn)證

除了上述驗(yàn)證類型，還可以創(chuàng)建下拉列表供用戶選擇：

# 創(chuàng)建下拉列表驗(yàn)證
rangeList = sheet.Range["C5"]
rangeList.DataValidation.AllowType = CellDataType.List
rangeList.DataValidation.Formula1 = '"選項(xiàng)1,選項(xiàng)2,選項(xiàng)3"'
rangeList.DataValidation.ShowDropDown = True

注意：下拉列表的選項(xiàng)需要使用雙引號包裹，并用逗號分隔。

從單元格范圍引用驗(yàn)證數(shù)據(jù)

可以從其他單元格范圍動態(tài)讀取驗(yàn)證數(shù)據(jù)：

# 從A1:A5范圍讀取列表數(shù)據(jù)
rangeDynamic = sheet.Range["D5"]
rangeDynamic.DataValidation.AllowType = CellDataType.List
rangeDynamic.DataValidation.Formula1 = "=A1:A5"

這種方式允許動態(tài)更新驗(yàn)證選項(xiàng)，無需修改代碼。

清除數(shù)據(jù)驗(yàn)證

如需移除已設(shè)置的驗(yàn)證規(guī)則：

# 清除指定單元格的驗(yàn)證
rangeToClear.DataValidation.Clear()

總結(jié)

本文介紹了如何使用 Python 在 Excel 中添加數(shù)據(jù)驗(yàn)證，包括數(shù)值范圍驗(yàn)證、日期驗(yàn)證和文本長度驗(yàn)證。通過合理配置 DataValidation 對象的屬性，可以實(shí)現(xiàn)靈活的數(shù)據(jù)輸入控制，提升電子表格的數(shù)據(jù)質(zhì)量和用戶體驗(yàn)。

這些技術(shù)特別適用于：

創(chuàng)建標(biāo)準(zhǔn)化數(shù)據(jù)錄入模板
構(gòu)建數(shù)據(jù)收集表單
實(shí)施數(shù)據(jù)質(zhì)量控制流程
開發(fā)自動化報表系統(tǒng)

掌握數(shù)據(jù)驗(yàn)證技術(shù)后，可以結(jié)合其他 Excel 操作功能（如條件格式、公式計(jì)算等），構(gòu)建更加完善的自動化辦公解決方案。

到此這篇關(guān)于Python在Excel工作表添加數(shù)據(jù)驗(yàn)證的示例代碼的文章就介紹到這了,更多相關(guān)Python Excel添加數(shù)據(jù)驗(yàn)證內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: