为何IPython/Spyder/Jupyter中xlwings向Excel发送空Matplotlib图表，终端却正常？

问题重现 #

运行Xlwings官方教程「Xlwings Matplotlib & Plotly Charts」中的代码：

import matplotlib.pyplot as plt
import xlwings as xw

fig = plt.figure()
plt.plot([1, 2, 3])

sheet = xw.Book().sheets[0]
sheet.pictures.add(fig, name='MyPlot', update=True)

环境配置：

• Windows 10
• Excel from Microsoft 365
• Anaconda3 2024.02-1
  • python 3.11.7
  • xlwings 0.29.1
  • matplotlib 3.8.0

现象：在Anaconda Prompt（cmd）中运行正常，图表显示完整；但在IPython、Spyder控制台或Jupyter Notebook中运行时，插入Excel的图表为空白。

解决方案 #

方法1：显式渲染图表 #

在调用sheet.pictures.add()前，强制matplotlib完成图表渲染：

import matplotlib.pyplot as plt
import xlwings as xw

fig = plt.figure()
plt.plot([1, 2, 3])

# 强制渲染图表，确保图像数据生成完成
fig.canvas.draw()

sheet = xw.Book().sheets[0]
sheet.pictures.add(fig, name='MyPlot', update=True)

方法2：切换Matplotlib后端为非交互式 #

在代码开头指定matplotlib使用非交互式后端，避免交互式环境的渲染冲突：

import matplotlib
matplotlib.use('Agg')  # 切换到非交互式后端，不依赖交互式窗口
import matplotlib.pyplot as plt
import xlwings as xw

fig = plt.figure()
plt.plot([1, 2, 3])

sheet = xw.Book().sheets[0]
sheet.pictures.add(fig, name='MyPlot', update=True)

方法3：通过内存图像数据传递 #

将图表保存到内存缓冲区，再传递给xlwings，兼容性最强：

import io
import matplotlib.pyplot as plt
import xlwings as xw

fig = plt.figure()
plt.plot([1, 2, 3])

# 将图表保存到内存中的字节缓冲区
img_buffer = io.BytesIO()
fig.savefig(img_buffer, format='png')
img_buffer.seek(0)  # 重置缓冲区指针到起始位置

sheet = xw.Book().sheets[0]
sheet.pictures.add(img_buffer, name='MyPlot', update=True)

原因说明 #

IPython、Spyder、Jupyter这类交互式环境默认使用交互式Matplotlib后端（如Qt5Agg、inline），这类后端会优先将图表渲染到交互式窗口或Notebook单元格，不会完全生成xlwings所需的离线图像数据。而Anaconda Prompt（cmd）默认使用非交互式后端（如Agg），会直接生成完整的离线图像数据，因此xlwings可以正确捕获并插入到Excel中。

内容的提问来源于stack exchange，提问作者user20836054