Python xlwings：实现数据逐行插入而非覆盖

本文详细介绍了如何使用Python的xlwings库向Excel文件逐行插入数据，而非重复覆盖同一单元格。通过引入一个递增的行号变量，并结合f-string动态构建单元格引用，确保每次循环都能将数据写入新的行。教程还强调了优化代码结构，如将Sheet对象定义移至循环外部，并提醒保存工作簿，从而提高代码效率和数据持久性。

1. 问题背景与常见误区

在使用 xlwings 向 Excel 工作表写入数据时，一个常见的需求是在每次迭代中将新数据添加到下一行，而不是覆盖前一次写入的数据。初学者常犯的错误是，在循环内部每次都引用相同的起始单元格（例如 sheet.range(‘A1’)），导致数据被反复覆盖，最终只保留最后一次写入的内容。

原始代码示例中展示了这一问题：

import pandas as pd
import xlwings as wx # 假设 wx 是 xlwings 的别名
# ... 文件加载部分略 ...
A = wx.Book(CompFile) # 打开工作簿
for row in l:
if row in m:
print('passed')
sheet = A.sheets['Source']
sheet.range('A1').value = row # 每次都写入 A1，导致覆盖

上述代码的问题在于 sheet.range(‘A1’).value = row 这一行，无论循环多少次，数据都尝试写入 A1 单元格，从而覆盖了之前写入的数据。

2. 解决方案：引入递增行号

解决此问题的核心思想是引入一个变量来跟踪当前要写入的行号，并在每次成功写入数据后递增该变量。这样，每次循环都可以动态地构建一个新的单元格引用，确保数据写入不同的行。

立即学习“Python免费学习笔记（深入）”；

关键步骤：

1. 初始化行号变量： 在循环开始之前，定义一个变量（例如 row_number）并将其初始化为期望的起始行号（通常为 1 或 2，如果第一行是标题）。
2. 动态构建单元格引用： 在循环内部，使用 f-string 或字符串拼接的方式，将列名（例如 ‘A’）与当前行号变量结合起来，形成形如 ‘A1’, ‘A2’, ‘A3’ 等的单元格地址。
3. 递增行号： 每次成功写入数据后，将行号变量加 1，为下一次写入做准备。

3. 优化后的代码示例

以下是经过优化和修正的代码，展示了如何实现数据的逐行插入：

import pandas as pd
import xlwings as xw # 规范使用 xw 作为 xlwings 的别名
# 假设 File1, File2, CompFile 变量已定义并指向正确的文件路径
# loadfile1 = pd.read_excel(File1)
# loadfile2 = pd.read_excel(File2)
# l = loadfile1.values.tolist()
# m = loadfile2.values.tolist()
# 示例数据，实际应用中替换为从文件加载的数据
l = [[1, 2, 3], [4, 5, 6], [7, 8, 9]]
m = [[4, 5, 6], [1, 2, 3], [10, 11, 12]]
# 打开或创建工作簿
# 注意：如果 CompFile 不存在，xlwings 会尝试创建它
# 如果 CompFile 存在，它将打开现有文件
try:
A = xw.Book(r'C:\path\to\your\CompFile.xlsx') # 请替换为你的实际文件路径
except FileNotFoundError:
print("文件不存在，将尝试创建新文件。")
A = xw.xw.Book() # 创建一个新的空工作簿
A.save(r'C:\path\to\your\CompFile.xlsx') # 保存到指定路径
A = xw.Book(r'C:\path\to\your\CompFile.xlsx') # 重新打开以确保正确引用
# 获取目标工作表对象。
# 最佳实践：将 Sheet 对象在循环外部获取一次，避免重复操作。
# 如果 'Source' 工作表不存在，可以先创建它
if 'Source' not in [sheet.name for sheet in A.sheets]:
A.sheets.add('Source')
sheet = A.sheets['Source']
# 初始化起始行号。如果想从 A1 开始，则为 1。
# 如果 Excel 表格有标题行，可以从 2 开始。
row_number = 1
print("开始处理数据并写入Excel...")
for row_data in l: # 使用更具描述性的变量名 row_data
if row_data in m:
print(f'匹配成功: {row_data}')
# 使用 f-string 动态构建单元格地址，例如 'A1', 'A2', 'A3'
# 注意：xlwings 写入列表时，会将列表元素横向展开
sheet.range(f'A{row_number}').value = row_data
row_number += 1  # 写入后，递增行号，指向下一行
# 不要忘记保存工作簿，否则更改不会被保存
A.save()
print("数据写入完成，文件已保存。")
# 关闭工作簿（可选，如果程序结束则会自动关闭）
A.close()

4. 注意事项与最佳实践

• Sheet 对象的位置： 将 sheet = A.sheets[‘Source’] 这一行移到循环外部。在每次循环中重复获取 Sheet 对象是不必要的开销，会降低性能。
• 行号初始化： 根据你的需求，调整 row_number 的初始值。如果 Excel 工作表的第一行是标题，你可能希望从 row_number = 2 开始写入数据。
• 数据类型： xlwings 在写入列表时，会将列表的每个元素依次写入到指定的起始单元格及其右侧的单元格。例如，sheet.range(‘A1’).value = [1, 2, 3] 会将 1 写入 A1，2 写入 B1，3 写入 C1。如果 row_data 是一个列表，它会横向填充。如果需要纵向填充，则需要调整写入逻辑或数据结构。
• 保存工作簿： 务必在所有数据写入完成后调用 A.save() 方法，否则你的更改将不会被保存到 Excel 文件中。
• 错误处理： 在实际应用中，考虑添加 try-except 块来处理文件不存在、工作表不存在等潜在错误。
• 文件路径： 确保 Excel 文件的路径是正确的，并且你的程序有权限访问该文件。
• 关闭工作簿： 在完成所有操作后，可以使用 A.close() 关闭工作簿，释放资源。

通过遵循上述指南和代码示例，你可以有效地使用 xlwings 库实现数据的逐行插入，避免数据覆盖问题，从而更好地自动化 Excel 操作流程。