使用 Python 复制 Excel 工作表

在处理复杂的 Excel 工作簿时，复制工作表是一项常见且实用的操作。无论是创建模板副本、在不同文件间迁移数据，还是保留原始数据的备份，掌握工作表复制技术都能显著提升工作效率。本文将深入探讨如何使用 Python 实现多种场景下的 Excel 工作表复制功能。

为什么需要复制 Excel 工作表

在办公自动化和数据处理场景中，复制工作表有着广泛的应用：

• 模板复用：基于现有工作表结构快速创建新的报表模板
• 数据备份：在进行大规模数据修改前保留原始数据快照
• 跨文件迁移：将特定工作表从一个工作簿转移到另一个工作簿
• 版本管理：保存不同阶段的数据状态以便对比分析
• 批量处理：为多个部门或项目创建结构相同的工作表

通过 Python 自动化这一过程，可以实现批量复制、条件筛选和集成到更大的数据处理流程中。

环境准备

在开始之前，需要安装支持 Excel 操作的 Python 库。Spire.XLS for Python 提供了全面的 API 来处理 XLSX 格式的工作簿，包括工作表复制功能。

pip install Spire.XLS

安装完成后，在 Python 脚本中导入相关模块即可开始工作：

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

基础复制流程

复制工作表的核心步骤包括：加载源工作簿、获取目标工作表、执行复制操作、保存结果。以下是最基础的跨文件复制示例：

当需要从一个 Excel 文件中复制整个工作表到另一个文件时，可以分别加载两个工作簿，然后使用 CopyFrom() 方法完成复制。这种方法适用于合并来自不同来源的数据或创建包含多个部门数据的综合报告：

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


# 定义输入输出路径
inputFile1 = "source_data.xlsx"
inputFile2 = "target_report.xlsx"
outputFile = "merged_report.xlsx"  

# 创建源工作簿对象并加载文件
sourceWorkbook = Workbook()
sourceWorkbook.LoadFromFile(inputFile1)
  
# 获取源工作表的第一个工作表
srcWorksheet = sourceWorkbook.Worksheets[0]  

# 创建目标工作簿对象并加载文件
targetWorkbook = Workbook()
targetWorkbook.LoadFromFile(inputFile2)  

# 添加一个新的工作表用于接收复制内容
targetWorksheet = targetWorkbook.Worksheets.Add("copied_data")

# 将源工作表复制到新添加的工作表中
targetWorksheet.CopyFrom(srcWorksheet)  

# 保存合并后的文档
targetWorkbook.SaveToFile(outputFile, ExcelVersion.Version2013)
targetWorkbook.Dispose()

上述代码展示了最基本的跨文件复制流程。CopyFrom() 方法是核心 API，它会将源工作表的所有内容（包括数据、格式、公式等）完整复制到目标工作表中。

在同一工作簿内复制工作表

有时你只需要在同一个工作簿内创建工作表的副本，而不涉及多个文件。这种操作常用于创建数据的不同版本或为不同用户准备个性化的工作表视图：

在同一个工作簿内进行复制时，可以先获取源工作表的数据范围，然后使用 Copy() 方法将其复制到新创建的工作表中。这种方式比跨文件复制更简单，因为不需要管理多个工作簿对象：

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

inputFile = "template_workbook.xlsx"
outputFile = "duplicated_sheets.xlsx"

# 创建工作簿对象并加载文件
workbook = Workbook()
workbook.LoadFromFile(inputFile)

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

# 添加一个新的工作表用于存放复制内容
sheet1 = workbook.Worksheets.Add("MySheet")

# 获取源工作表的已分配区域（包含数据的区域）
sourceRange = sheet.AllocatedRange

# 将源工作表的数据复制到新工作表
# 参数说明：源范围、目标工作表、起始行、起始列、是否复制格式
sheet.Copy(sourceRange, sheet1, sheet.FirstRow, sheet.FirstColumn, True)


# 保存修改后的文档
workbook.SaveToFile(outputFile, ExcelVersion.Version2013)
workbook.Dispose()

Copy() 方法提供了更细粒度的控制，可以指定复制的起始位置、是否包含格式等选项。这对于需要精确定位复制内容的场景非常有用。

复制工作表到另一个 Excel 文件

在实际工作中，经常需要将某个 Excel 文件中的完整工作表（包括页面设置、打印区域等）复制到另一个文件中。这种操作比简单的数据复制更复杂，因为要保留所有的工作表属性：

当需要完整复制工作表的所有属性（如页眉页脚、打印设置、重复标题行等）时，CopyFrom() 方法会自动处理这些细节。下面的示例还演示了如何在复制前为源工作表设置打印标题行：

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

inputFile = "source_with_settings.xlsx"
outputFile = "destination_file.xlsx"

# 创建工作簿并获取第一个工作表
workbook = Workbook()
sheet = workbook.Worksheets[0] 

# 在源工作表中填充一些示例数据
for i in range(1, 6):
sheet.Range["A" + str(i)].Text = "标题行 {0}".format(i)

# 填充更多详细数据
for i in range(5, 100):
sheet.Range["A" + str(i)].Text = "数据行 {0}".format(i)

# 定义页面设置对象并配置打印标题行
pageSetup = sheet.PageSetup
pageSetup.PrintTitleRows = "$1:$5" # 每页重复前 5 行

# 创建另一个工作簿作为目标文件
workbook1 = Workbook()
sheet1 = workbook1.Worksheets[0]

# 将配置好页面设置的源工作表复制到目标工作簿
sheet1.CopyFrom(sheet)

# 保存目标文件
workbook1.SaveToFile(outputFile, ExcelVersion.Version2013)
workbook.Dispose()

这个示例展示了如何保留页面设置等高级属性。PrintTitleRows 设置会在复制过程中一并迁移，确保目标工作表的打印效果与源工作表完全一致。

选择性复制可见工作表

某些 Excel 文件可能包含隐藏的工作表，用于存储敏感数据或中间计算结果。在分享文件时，你可能只想复制可见的工作表而排除隐藏内容：

通过遍历工作簿中的所有工作表并检查其 Visibility 属性，可以有选择性地只复制可见的工作表。这种方法特别适合批量处理包含隐藏数据的工作簿，确保输出的文件只包含公开信息：

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

inputFile = "workbook_with_hidden.xlsx"
outputFile = "visible_sheets_only.xlsx"

# 加载包含隐藏工作表的源文件
workbook = Workbook()
workbook.LoadFromFile(inputFile)

# 创建一个新的工作簿用于存放可见工作表
workbookNew = Workbook()
workbookNew.Version = ExcelVersion.Version2013
workbookNew.Worksheets.Clear()

# 遍历源工作簿中的所有工作表
for sheet in workbook.Worksheets:
# 判断工作表是否可见
if sheet.Visibility == WorksheetVisibility.Visible:
# 只复制可见的工作表到新工作簿
name = sheet.Name
workbookNew.Worksheets.AddCopy(sheet)

# 保存只包含可见工作表的新文件
workbookNew.SaveToFile(outputFile, ExcelVersion.Version2013)
workbook.Dispose()

AddCopy() 方法会完整复制工作表的所有内容和格式，同时自动处理工作表名称冲突问题。这种选择性复制对于数据脱敏和信息共享非常有用。

实战：批量创建工作表副本

结合以上技术，可以构建一个批量创建工作表副本的实用工具：

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

class WorksheetCopier:
    def __init__(self, source_file):
        self.source_file = source_file
        self.source_workbook = Workbook()
        # 预先加载源文件
        self.source_workbook.LoadFromFile(source_file)

    def copy_to_new_workbook(self, sheet_indices, output_file):
        """将指定索引的工作表复制到全新的工作簿中"""
        new_workbook = Workbook()
        new_workbook.Version = ExcelVersion.Version2013
        # 清除新工作簿默认生成的空表
        new_workbook.Worksheets.Clear()
        
        for index in sheet_indices:
            if index < self.source_workbook.Worksheets.Count:
                source_sheet = self.source_workbook.Worksheets[index]
                # 使用 AddCopy 完整保留格式和数据
                new_workbook.Worksheets.AddCopy(source_sheet)
                print(f"已复制工作表：{source_sheet.Name}")
        
        new_workbook.SaveToFile(output_file, ExcelVersion.Version2013)
        new_workbook.Dispose()
        print(f"新文件已保存至：{output_file}")

    def duplicate_within_workbook(self, sheet_name, prefix="Copy_"):
        """在同一个工作簿内部克隆指定名称的工作表"""
        # 注意：若要在原文件基础上修改，需重新加载以保证操作的是最新状态
        temp_workbook = Workbook()
        temp_workbook.LoadFromFile(self.source_file)

        # 查找目标工作表
        source_sheet = None
        for sheet in temp_workbook.Worksheets:
            if sheet.Name == sheet_name:
                source_sheet = sheet
                break

        if source_sheet:
            # 直接在该工作簿中克隆一份
            new_sheet = temp_workbook.Worksheets.AddCopy(source_sheet)
            new_sheet.Name = prefix + sheet_name
            
            output_file = "duplicated_" + os.path.basename(self.source_file)
            temp_workbook.SaveToFile(output_file, ExcelVersion.Version2013)
            print(f"已在工作簿内完成副本创建：{sheet_name} -> {new_sheet.Name}")
        else:
            print(f"未找到名为 '{sheet_name}' 的工作表")
        
        temp_workbook.Dispose()

    def close(self):
        """释放初始加载的资源"""
        if self.source_workbook:
            self.source_workbook.Dispose()

# --- 使用示例 ---
if __name__ == "__main__":
    # 请确保目录下存在 master_template.xlsx 文件
    if os.path.exists("master_template.xlsx"):
        copier = WorksheetCopier("master_template.xlsx")
        
        # 1. 提取索引为 0 和 1 的表到新文件
        copier.copy_to_new_workbook([0, 1], "selected_sheets.xlsx")
        
        # 2. 在工作簿内创建 "Sales_Data" 的备份
        copier.duplicate_within_workbook("Sales_Data", prefix="Backup_")
        
        copier.close()
    else:
        print("错误：找不到指定的 master_template.xlsx 文件。")

这个实用类提供了：

• 按索引选择性地复制工作表
• 在工作簿内部创建工作表副本
• 自定义新工作表的命名前缀
• 资源管理和错误处理

常见问题与解决方案

问题 1：复制后格式丢失

确保在 Copy() 方法中将最后一个参数设置为 True 以包含格式：

sheet.Copy(sourceRange, sheet1, row, col, True) # True 表示复制格式

问题 2：工作表名称冲突

在复制前检查目标工作簿中是否已存在同名工作表，必要时重命名：

# 假设这是在某个方法内部
def some_method(self, target_name):
    # 1. 确保 workbook 变量已定义（例如指向当前工作簿）
    workbook = self.source_workbook 
    
    # 2. 正确缩进的列表推导式
    existing_names = [s.Name for s in workbook.Worksheets]
    
    # 3. 检查是否存在并重命名
    if target_name in existing_names:
        target_name = target_name + "_copy"
        
    return target_name

问题 3：隐藏工作表被意外复制

使用可见性检查来过滤隐藏工作表：

if sheet.Visibility == WorksheetVisibility.Visible:
workbookNew.Worksheets.AddCopy(sheet)

问题 4：大型文件复制缓慢

对于包含大量数据的工作表，考虑只复制必要的区域而非整个工作表：

# 只复制使用的数据范围
specific_range = sheet.Range["A1:Z1000"]
# 进行针对性复制操作

总结

复制 Excel 工作表是办公自动化中的基础技能。通过本文的介绍，我们学习了：

1. 使用 CopyFrom() 方法进行跨文件完整工作表复制
2. 使用 Copy() 方法在同一工作簿内精确控制复制位置
3. 保留页面设置、打印区域等高级属性的复制技巧
4. 选择性复制可见工作表的数据脱敏方法
5. 构建批量复制工具类的实战应用

这些技术可以直接应用于报表模板分发、多部门数据汇总、历史数据归档等实际场景。掌握了基础的复制方法后，还可以进一步探索条件格式化复制、图表和工作表对象的复制、以及与其他 Office 应用的集成，构建更加完善的文档自动化系统。