Python 高效添加与管理 Excel 工作表

在日常数据处理和报表生成中，我们经常需要向已有的 Excel 文件添加新的工作表（Worksheet），或者动态创建包含多个工作表的 Excel 文件。本文将介绍如何使用免费库 Free Spire.XLS for Python 通过简洁代码实现 Excel 工作表的新建、批量添加、位置调整、删除与查重等核心操作

安装所需库
bash 复制代码
pip install Spire.Xls.Free

基础用法：新建 Excel 并添加工作表

下面的示例创建一个新的工作簿，删除默认工作表，自定义工作表名称并写入基础数据，是最常用的基础场景。

python 复制代码

from spire.xls import *

# 创建 Workbook 对象
workbook = Workbook()

# 删除默认生成的第一个工作表（可选）
workbook.Worksheets.Clear()

# 添加第一个工作表
sheet1 = workbook.Worksheets.Add("销售数据")
sheet1.Range["A1"].Text = "月份"
sheet1.Range["B1"].Text = "销售额"

# 保存文件
workbook.SaveToFile("添加工作表.xlsx", FileFormat.Version2016)
workbook.Dispose()

批量添加多个空白工作表

使用 CreateEmptySheets 方法可以一次性创建多个空白工作表（该方法会清空原有的所有工作表）。

python 复制代码

from spire.xls import *

workbook = Workbook()

# 创建 3 个空白工作表（原有工作表将被清空）
sheetCount = 3
workbook.CreateEmptySheets(sheetCount)

# 保存结果文件
workbook.SaveToFile("多工作表示例.xlsx", ExcelVersion.Version2013)
workbook.Dispose()

向现有 Excel 文件添加工作表

更常见的场景是打开一个已有的 Excel 文件，然后在末尾追加新的工作表。

python 复制代码

from spire.xls import *

# 加载现有文件
workbook = Workbook()
workbook.LoadFromFile("年度报告.xlsx")

# 添加新工作表
new_sheet = workbook.Worksheets.Add("第四季度数据")
new_sheet.Range["A1"].Text = "季度"
new_sheet.Range["B1"].Text = "营收"

# 写入几行示例数据
for i in range(1, 4):
    new_sheet.Range[f"A{i+1}"].Text = f"Q{i}"
    new_sheet.Range[f"B{i+1}"].NumberValue = 10000 * i

# 保存（可覆盖原文件或另存为新文件）
workbook.SaveToFile("年度报告_更新.xlsx", FileFormat.Version2016)
workbook.Dispose()

进阶操作：移动位置和删除工作表

移动工作表顺序

通过工作表的 MoveWorksheet 方法可以调整其在工作簿中的位置。参数为目标索引（从 0 开始计数）。

python 复制代码

# 获取第一个工作表
sheet = workbook.Worksheets[0]

# 将该工作表移动到索引 2 的位置（即第三个工作表）
sheet.MoveWorksheet(2)

注意：执行移动操作前需先加载或创建 workbook 对象。

删除工作表

支持按索引删除 和按表名删除两种方式：

python 复制代码

# 按索引删除（删除第一个工作表）
workbook.Worksheets.RemoveAt(0)

# 按名称删除
worksheet = workbook.Worksheets["Sheet1"]
workbook.Worksheets.Remove(worksheet)

检查工作表是否存在

在自动化脚本中，为了避免因重复添加同名工作表而报错，可以封装一个检查函数：

python 复制代码

def add_sheet_if_not_exists(workbook, sheet_name):
    for sheet in workbook.Worksheets:
        if sheet.Name == sheet_name:
            print(f"工作表 '{sheet_name}' 已存在")
            return None
    new_sheet = workbook.Worksheets.Add(sheet_name)
    print(f"成功添加工作表 '{sheet_name}'")
    return new_sheet

# 使用示例
workbook = Workbook()
workbook.LoadFromFile("数据.xlsx")
add_sheet_if_not_exists(workbook, "新分析表")
workbook.SaveToFile("数据_更新.xlsx", FileFormat.Version2016)
workbook.Dispose()

注意事项

免费版限制

Free Spire.XLS for Python 的免费版本对每个工作表可处理的工作表数量和行数有一定限制。对于简单报表和小规模数据处理完全足够。若需要处理大量数据，建议评估其他开源方案（如 openpyxl）。
文件格式

保存时建议使用 FileFormat.Version2016 或 Version2013，生成标准的 .xlsx 文件。如需保存为旧版 .xls 格式，可使用 Version97to2003。
资源释放

操作完成后请调用 workbook.Dispose() 释放资源，尤其在循环或批量处理场景中，以避免内存占用。

总结

添加 Excel 工作表仅需几行代码：创建或加载 Workbook，调用 Worksheets.Add() 方法，最后保存文件。该库提供了直观的 API 来管理工作表名称、位置和内容，且代码简洁、无 Office 依赖，非常适合在自动化脚本、报表系统中快速生成多工作表 Excel。