Python中Pandas导出Excel时如何实现追加模式不覆盖-Python教程-PHP中文网

pandas用openpyxl引擎的mode="a"仅支持追加新sheet或覆盖已有sheet；真正在已有sheet末尾追加数据，必须手动读取原sheet、计算最后一行、再逐单元格写入。

python中pandas导出excel时如何实现追加模式不覆盖

用 `openpyxl` 引擎配合 `ExcelWriter` 的 `mode="a"`

直接设 mode="a" 是最接近“追加”的方式，但 Pandas 本身不支持像文件那样追加写入新行——它只支持追加写入**新 sheet** 或**覆盖已有 sheet**。真正实现“在已有 sheet 末尾追加数据”，必须手动读取原 sheet、拼接、再写回。

mode="a" 仅在引擎为 openpyxl 时有效；xlsxwriter 不支持追加模式，会报错 ValueError: Append mode is not supported with xlsxwriter
即使用了 openpyxl，ExcelWriter(..., mode="a") 默认也不会自动定位到最后一行；它只是打开文件并允许你写新 sheet，或用 if_sheet_exists="overlay"（Pandas 1.4+）叠加内容，但叠加位置仍需手动控制
若目标 sheet 已存在且想追加数据，必须先用 openpyxl.load_workbook() 读取，获取最大行号，再把 DataFrame 转成列表逐行写入

手动读取 + 定位最后一行 + 写入（推荐稳定方案）

这是唯一能确保数据追加到指定 sheet 末尾的可靠做法，尤其适用于日志类、采集类场景。关键不是靠 Pandas 自动推断，而是自己算好起始行。

用 openpyxl.load_workbook() 打开文件，用 ws.max_row 获取当前最后一行（注意：空行也会计入，建议用 ws.calculate_dimension() 或遍历非空行校验）
用 ws.append(...) 只能追加在末尾，但无法控制列宽/格式；如需保留原格式（如日期列、数字格式），得用 ws.cell(row=..., column=...).value = ... 逐单元格赋值
DataFrame 写入前建议调用 df.values.tolist()，避免 NaN 写成 None 导致 openpyxl 报错；对时间类型，需转为 datetime 对象而非字符串

<pre class="brush:php;toolbar:false;">from openpyxl import load_workbook
import pandas as pd
<p>df = pd.DataFrame({"A": [1, 2], "B": ["x", "y"]})
wb = load_workbook("data.xlsx")
ws = wb["Sheet1"]
start_row = ws.max_row + 1</p><p>for r_idx, row in enumerate(df.values, start_row):
for c_idx, value in enumerate(row, 1):
ws.cell(row=r_idx, column=c_idx, value=value)</p><p>wb.save("data.xlsx")</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill6591" title="Li Python Sec Check"><img
														src="https://img.php.cn/upload/skill/000/000/081/179102166033725.jpg" alt="Li Python Sec Check" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill6591" title="Li Python Sec Check" class="overflowclass">Li Python Sec Check</a>
													<p class="overflowclass">Python 安全规范检查工具：基于 CloudBase 规范、腾讯安全指南，LLM 智能分析（默认禁用，优先本地执行）</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill6591" title="Li Python Sec Check" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>

用 `if_sheet_exists="overlay"`

配合 startrow（Pandas 1.4+）

这个参数看似简化流程，但容易误以为“自动追加”，实际只是覆盖式写入——它不会帮你找最后一行，startrow 必须显式传入，否则默认从第 0 行开始，直接覆盖原数据。

必须提前知道目标 sheet 当前有多少行，否则无法安全设置 startrow；可结合 pandas.read_excel(..., nrows=0) 快速读表头+行数，但不读数据，性能尚可
if_sheet_exists="overlay" 仅控制写入行为，不处理样式、合并单元格、公式等；原有格式会丢失
若原 sheet 有冻结窗格、筛选器等，写入后仍保留，但新增行不在筛选范围内，需手动刷新