使用 Python 操作 Excel 文件中的工作表(添加和删除)

张开发
2026/4/9 21:45:15 15 分钟阅读

分享文章

使用 Python 操作 Excel 文件中的工作表(添加和删除)
在处理复杂的 Excel 文档时工作表的管理是一项基础而重要的技能。无论是需要为不同部门创建独立的数据表格还是清理不再需要的旧数据灵活地添加和删除工作表都能帮助我们更好地组织和管理数据。本文将介绍如何使用 Python 和 Spire.XLS 库来管理 Excel 工作簿中的工作表包括添加新工作表、删除现有工作表以及获取工作表信息等常用操作。为什么需要程序化管理工作表在实际业务场景中我们经常需要动态管理工作表自动化报表生成根据数据源自动创建对应数量的工作表例如为每个销售区域生成独立的统计表格数据整理与归档定期清理过期的工作表保持文件整洁模板化处理基于标准模板批量生成包含特定工作表结构的新文件动态数据结构根据用户需求动态调整工作表数量和名称通过编程方式实现这些操作可以显著提升工作效率减少重复性手工劳动。环境准备首先需要安装 Spire.XLS for Python 库。可以通过 pip 命令进行安装pipinstallSpire.XLS安装完成后即可在 Python 脚本中导入并使用该库提供的工作表管理功能。添加新工作表基本添加操作向现有工作簿中添加新工作表是最常见的操作之一。Spire.XLS 提供了Add方法来实现这一功能该方法允许我们指定新工作表的名称并返回新创建的工作表对象方便后续操作。以下代码演示了如何加载一个现有的 Excel 文件并向其中添加一个名为AddedSheet的新工作表fromspire.xlsimport*fromspire.xls.commonimport*# 定义输入输出文件路径inputFile./Demos/Data/AddWorksheet.xlsxoutputFileAddWorksheet.xlsx# 创建 Workbook 对象并加载文件workbookWorkbook()workbook.LoadFromFile(inputFile)# 添加一个名为 AddedSheet 的新工作表sheetworkbook.Worksheets.Add(AddedSheet)# 在新工作表中写入内容sheet.Range[C5].TextThis is a new sheet.# 保存文件并释放资源workbook.SaveToFile(outputFile,ExcelVersion.Version2013)workbook.Dispose()在这个示例中Worksheets.Add()方法接受一个字符串参数作为工作表名称并返回新创建的工作表对象。我们可以直接使用这个对象来设置单元格内容、格式化样式或进行其他操作。这种方式非常直观适合需要在添加工作表后立即进行内容填充的场景。批量创建工作表当需要一次性创建多个工作表时可以使用CreateEmptySheets方法。这个方法在创建空白工作簿时特别有用可以快速生成指定数量的工作表。下面的示例展示了如何创建一个包含 5 个工作表的 Excel 文件并为每个工作表命名和填充示例数据fromspire.xls.commonimport*fromspire.xlsimport*# 定义输出文件路径outputFileCreateAnExcelWithFiveSheet.xlsx# 创建空的 Workbook 对象workbookWorkbook()# 创建 5 个空白工作表workbook.CreateEmptySheets(5)# 遍历每个工作表设置名称并填充数据foriinrange(0,5):sheetworkbook.Worksheets[i]sheet.NameSheetstr(i)# 在每个工作表中填充示例数据forrowinrange(1,151):forcolinrange(1,51):sheet.Range[row,col].Textrowstr(row) colstr(col)# 保存文件并释放资源workbook.SaveToFile(outputFile,ExcelVersion.Version2010)workbook.Dispose()这个示例展示了完整的批量创建流程使用CreateEmptySheets(5)一次性创建 5 个空白工作表通过索引访问每个工作表并设置名称使用嵌套循环为每个工作表填充示例数据这种方法非常适合生成标准化的多工作表模板或者在数据处理前预先准备好所需的工作表结构。删除工作表按索引删除工作表当工作簿中包含不再需要的工作表时我们可以将其删除以保持文件整洁。Spire.XLS 提供了RemoveAt方法允许我们通过索引位置来删除指定的工作表。以下代码展示了如何删除工作簿中的第二个工作表索引为 1fromspire.xlsimport*fromspire.xls.commonimport*# 定义输入输出文件路径inputFile./Demos/Data/RemoveWorksheet.xlsxoutputFileRemoveWorksheet.xlsx# 创建 Workbook 对象并加载文件workbookWorkbook()workbook.LoadFromFile(inputFile)# 通过索引删除第二个工作表索引从 0 开始workbook.Worksheets.RemoveAt(1)# 保存文件并释放资源workbook.SaveToFile(outputFile,ExcelVersion.Version2013)workbook.Dispose()需要注意的是工作表的索引是从 0 开始的因此RemoveAt(1)实际上删除的是第二个工作表。在执行删除操作后剩余工作表的索引会自动调整。如果需要根据名称而非索引来删除工作表可以先遍历工作表集合找到对应的索引然后再执行删除操作。智能删除根据条件筛选在实际应用中我们可能需要根据特定条件来决定删除哪些工作表。例如删除所有名称包含临时或备份字样的工作表。虽然基础 API 只提供了按索引删除的功能但我们可以结合遍历逻辑来实现更智能的删除策略。fromspire.xlsimport*fromspire.xls.commonimport*# 定义输入输出文件路径inputFile./Demos/Data/RemoveWorksheet.xlsxoutputFileRemoveWorksheet_Conditional.xlsx# 创建 Workbook 对象并加载文件workbookWorkbook()workbook.LoadFromFile(inputFile)# 收集需要删除的工作表索引从后往前遍历避免索引变化问题indexes_to_remove[]foriinrange(workbook.Worksheets.Count-1,-1,-1):sheetworkbook.Worksheets[i]# 如果工作表名称包含特定关键词则标记为删除if临时insheet.Nameor备份insheet.Name:indexes_to_remove.append(i)# 执行删除操作forindexinindexes_to_remove:workbook.Worksheets.RemoveAt(index)# 保存文件并释放资源workbook.SaveToFile(outputFile,ExcelVersion.Version2013)workbook.Dispose()这个示例展示了如何实现条件删除从后往前遍历所有工作表收集需要删除的索引从后往前删除是为了避免删除操作导致索引变化而影响后续删除根据工作表名称中的关键词判断是否需要删除这种模式可以灵活扩展支持各种复杂的删除条件。获取工作表信息在管理工作表之前了解当前工作簿中包含哪些工作表是非常有用的。我们可以遍历工作表集合来获取所有工作表的名称和其他属性。以下代码演示了如何获取并保存所有工作表的名称fromspire.xlsimport*fromspire.xls.commonimport*defAppendAllText(fname:str,text:list):辅助函数将列表中的文本写入文件fpopen(fname,w,encodingutf-8)forsintext:fp.write(s\n)fp.close()# 定义输入输出文件路径inputFile./Demos/Data/WorksheetSample3.xlsxoutputFileOutputGetWorksheetNames.txt# 创建 Workbook 对象并加载文件workbookWorkbook()workbook.LoadFromFile(inputFile)# 获取所有工作表的名称sb[]forsheetinworkbook.Worksheets:sb.append(sheet.Name)# 将工作表名称保存到文本文件AppendAllText(outputFile,sb)# 释放资源workbook.Dispose()这个示例展示了一个实用的工具函数可以提取工作簿中所有工作表的名称并保存到文本文件中。这种功能在以下场景中非常有用文档审计快速了解大型 Excel 文件的结构自动化处理在批量处理前确认工作表列表生成目录为复杂的工作簿创建索引或导航页面实际应用综合示例在实际工作中添加和删除工作表的操作往往需要结合使用。以下是一个综合示例展示了如何根据数据动态管理工作表fromspire.xlsimport*fromspire.xls.commonimport*# 定义输出文件路径outputFileDynamicWorksheetManagement.xlsx# 创建新的 Workbook 对象workbookWorkbook()# 假设我们有三个部门的数据需要分别放入不同的工作表departments[销售部,市场部,技术部]# 为每个部门创建一个工作表fordeptindepartments:sheetworkbook.Worksheets.Add(dept)# 在每个工作表中添加标题sheet.Range[A1].Valuef{dept}- 月度报告sheet.Range[A1].Style.Font.IsBoldTruesheet.Range[A1].Style.Font.Size14# 添加示例数据列标题sheet.Range[A3].Value项目名称sheet.Range[B3].Value金额sheet.Range[C3].Value日期# 设置列标题样式sheet.Range[A3:C3].Style.Font.IsBoldTruesheet.Range[A3:C3].Style.ColorColor.LightGray# 删除默认创建的空白工作表如果有whileworkbook.Worksheets.Countlen(departments):workbook.Worksheets.RemoveAt(0)# 保存文件并释放资源workbook.SaveToFile(outputFile,ExcelVersion.Version2013)workbook.Dispose()这个综合示例展示了完整的工作表管理流程根据部门列表动态创建工作表为每个工作表设置名称和初始内容清理不需要的默认工作表最终得到一个结构清晰、内容规范的多工作表文件实用技巧在管理工作表时以下技巧可以帮助提高效率和代码质量索引注意事项删除工作表后剩余工作表的索引会重新排列。如果需要删除多个工作表建议从后往前遍历或者先收集索引再统一删除。名称唯一性工作表名称在工作簿中必须是唯一的。尝试添加同名工作表会导致错误因此在添加前应检查名称是否已存在。最小工作表数量Excel 工作簿至少需要保留一个工作表不能删除所有工作表。在执行删除操作前应检查工作表数量。性能优化当需要大量修改工作表时建议在内存中完成所有操作后再保存文件避免频繁的磁盘 I/O 操作。总结通过本文的介绍我们学习了使用 Python 和 Spire.XLS 库管理 Excel 工作表的多种方法使用Add方法添加单个新工作表并可立即对其进行操作使用CreateEmptySheets方法批量创建空白工作表使用RemoveAt方法按索引删除工作表结合遍历逻辑实现条件删除和智能管理使用遍历工作表集合获取工作表信息这些方法为 Excel 文件的自动化处理提供了坚实的基础。掌握这些技巧后您将能够更高效地管理和组织复杂的 Excel 文档实现真正的自动化办公流程。

更多文章