最稳做法是用 openpyxl 加载原始模板（含格式），通过字典映射批量写入指定单元格，none/decimal/datetime 需手动转换，合并单元格需注意左上角坐标，输出路径动态生成避免覆盖模板。
用 pandas + openpyxl 写入固定单元格位置最稳
直接写死单元格（比如 A2、D7）比“追加数据”或“覆盖整列”更符合“严格模板”需求。用 pandas 读库后，别急着 to_excel —— 它不支持精确定位写入；得交棒给 openpyxl 操作已存在的 .xlsx 文件。
常见错误是：先用 pandas 写出空表，再用 openpyxl 打开修改，结果样式/合并单元格/页眉页脚全丢。正确做法是：用 openpyxl.load_workbook 加载原始模板文件（含格式、冻结窗格、条件格式等），只改指定单元格值。
- 确保模板 Excel 是
.xlsx格式（.xls不支持openpyxl） - 数据库字段名和模板单元格要人工对齐好，比如
user_name→B3，order_date→E5 - 写入前先调用
wb.active或wb['Sheet1']明确工作表，避免默认表被意外覆盖
openpyxl 写单元格时注意类型和格式继承
数据库查出来的 datetime、Decimal、None 直接赋值给 cell.value 会出问题：Excel 可能显示为 1900-01-01 或 0，甚至报 ValueError: Cannot convert None to Excel。
必须手动转换：
-
None→ 改成空字符串''或保持None（但需确认单元格原格式是否允许空值） -
datetime.date/datetime.datetime→ 直接赋值，openpyxl能识别（前提是单元格没被设成文本格式） -
Decimal('123.45')→ 转float()或str()，取决于模板里该单元格是否要参与计算 - 如果模板中某单元格有自定义数字格式（如
"¥#,##0.00"），写入数字后格式自动生效；但写入字符串会失效
批量写入多个单元格？别用循环逐个 ws['A1'] = ...
单个赋值看着直观，但写几十个单元格时性能差、易错、难维护。推荐用字典映射 + 批量更新：
cell_mapping = {
'A1': db_result['company_name'],
'B3': str(db_result['total_amount']),
'D7': db_result['report_date'].strftime('%Y-%m-%d'),
}
for coord, value in cell_mapping.items():
ws[coord].value = value
这样逻辑集中，增减字段只改字典，不碰循环体。注意 coord 必须是合法地址（如 'Z100' 合法，'AA1' 也合法，但 'A1:' 或 '1A' 会报 ValueError）。
另一个坑：如果模板里 A1 是合并单元格（merge_cells），直接 ws['A1'].value = ... 只影响左上角单元格，视觉上没变化。得先取消合并或写入合并区域的左上角坐标（通常是合并范围的第一个）。
写完记得 save，但别覆盖原模板文件
调试阶段绝对不要 wb.save('template.xlsx') —— 一跑错就毁模板。固定套路是：
- 输入模板路径：
template_path = 'report_template.xlsx' - 输出路径动态生成：
output_path = f'report_{int(time.time())}.xlsx' - 用
shutil.copy(template_path, output_path)复制一份再加载，确保每次都是干净起点 - 最后
wb.save(output_path)，而不是原路径
还有个隐蔽问题：如果模板里用了外部链接、数据验证或宏，openpyxl 读取后这些内容会被静默丢弃。真需要保留，得换 win32com（Windows 专用）或接受限制。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
