用openpyxl插入折线图需创建LineChart对象,通过Reference指定X轴(如A2:A10)和Y轴(如B1:B10)数据范围,调用set_categories和add_data绑定数据,设置标题、坐标轴名及宽高后,用add_chart插入指定单元格,最后用Excel打开验证图表显示。

用 openpyxl 插入折线图,核心是创建 LineChart 对象、添加数据系列(Reference 和 Series),再把图表加到工作表中。不依赖 Excel 打开状态,纯代码生成,但要注意数据引用范围和坐标轴设置。
准备数据区域
折线图需要明确的 X 轴(类别)和 Y 轴(数值)数据。通常 X 轴放在第一列(如 A2:A10),Y 轴放在相邻列(如 B2:B10)。确保数据连续、无空行空列,且首行为标题(可选,但建议保留以便自动识别)。
- 数据从第 2 行开始,避免把表头当数值读取
- 若有多组折线,每组占一列(如 B 列、C 列),X 轴共用同一列
- 用
ws.cell(row=..., column=...).value = ...或ws.append(...)写入数据更稳妥
创建 LineChart 并绑定数据
先导入 LineChart 和 Reference,然后指定数据源。关键在 Reference 的范围要准确——X 轴用 min_col/max_col 控制列,Y 轴用 min_row/max_row 控制行。
- X 轴引用:例如
Reference(ws, min_col=1, min_row=2, max_row=10)(A2:A10) - Y 轴引用:例如
Reference(ws, min_col=2, min_row=1, max_row=10)(B1:B10),含标题行才设min_row=1 - 用
chart.set_categories(x_data)设置横坐标,chart.add_data(y_data, titles_from_data=True)加入折线(True 表示首行作图例名)
调整图表样式与位置
openpyxl 默认图表较小且无标题。可通过属性微调,再用 ws.add_chart(..., "D2") 指定左上角单元格锚点。
立即学习“Python免费学习笔记(深入)”;
- 加标题:
chart.title = "销售趋势" - 设坐标轴名称:
chart.x_axis.title = "月份",chart.y_axis.title = "销售额(万元)" - 改大小(单位为 EMU):
chart.width = 480,chart.height = 288 - 插入位置写成字符串,如
"E5",不是元组或数字索引
保存文件并验证
调用 wb.save("report.xlsx") 后,必须用 Excel(而非 WPS 或网页版)打开才能正常显示图表——openpyxl 生成的是标准 OOXML 图表,部分兼容性较弱的工具可能只显示空白框。
- 如果图表不显示,先检查是否漏掉
add_data()或set_categories() - 数据为字符串或空值会导致折线消失,可用
print([cell.value for cell in ws['B2:B10']])快速排查 - 不支持动态公式引用(如
=Sheet1!A1*2),所有数据需为实际数值或文本
基本上就这些。不复杂但容易忽略引用范围和保存后的查看环境。










