### 如何使用 Pandas 向现有 Excel 文件续写数据 要实现向现有的 Excel 文件中追加数据而不会覆盖原有内容的功能，可以结合 `pandas` 和 `openpyxl` 引擎来完成此操作。以下是具体方法： #### 方法概述 通过创建一个临时的 DataFrame 并将其附加到已有的 Excel 表格中，同时保留原始格式和数据。 --- #### 实现代码示例 ```python import pandas as pd def append_df_to_excel(filename, df, sheet_name='Sheet1', startrow=None, truncate_sheet=False, **to_excel_kwargs): """ 将新的 DataFrame 追加到现有的 Excel 文件中。 参数: filename : str 要保存的目标 Excel 文件路径 (例如 '.xlsx'). df : pandas.DataFrame 待追加的数据框. sheet_name : str, default 'Sheet1' 工作表名称. startrow : int, default None 开始写入的新数据所在行号（索引从 0 开始）. truncate_sheet : bool, default False 是否清空目标工作表中的所有数据后再写入新数据. to_excel_kwargs : dict, optional 可选参数传递给 `DataFrame.to_excel`. """ from openpyxl import load_workbook try: f = None writer = pd.ExcelWriter(filename, engine='openpyxl') if os.path.exists(filename): book = load_workbook(filename) writer.book = book if startrow is not None and sheet_name in writer.book.sheetnames: worksheet = writer.book[sheet_name] last_row = worksheet.max_row else: last_row = 0 if truncate_sheet and sheet_name in writer.book.sheetnames: idx = writer.book.sheetnames.index(sheet_name) writer.book.remove(writer.book.worksheets[idx]) writer.book.create_sheet(sheet_name, idx) else: last_row = 0 df.to_excel(writer, sheet_name, startrow=startrow or last_row, index=False, header=(last_row==0), **to_excel_kwargs) writer.save() writer.close() except Exception as e: raise ValueError(f"发生错误：{e}") ``` 上述函数实现了将一个新的 DataFrame 数据追加至指定的工作簿中[^1]。如果文件不存在，则会自动创建；如果存在则会在最后一行继续写入数据而不破坏已有结构[^3]。 --- #### 关键点解析 - **保持原格式不变**：利用 `openpyxl` 引擎能够很好地保护原有的单元格样式、字体颜色以及其他属性不受影响。 - **动态定位起始位置**：通过判断当前表格的最大行数 (`worksheet.max_row`) 来决定下一次写入的位置起点。 - **灵活控制头部信息**：当首次写入时设置头信息(`header=True`) ，后续追加时不重复添加列标题(`header=False`) [^2]. --- #### 注意事项 确保安装了必要的依赖包： ```bash pip install pandas openpyxl ``` 另外需要注意的是，在实际应用过程中可能会遇到一些特殊情况比如多线程并发修改同一个 excel 文档等问题需额外处理锁机制加以防范冲突情况的发生。 ---