如何在Jupyter Notebook中显示带透明背景的Matplotlib图像？

问题现象 #

以下代码在Jupyter QtConsole（执行jupyter qtconsole --style monokai启动）中能正常渲染带透明背景的图像，但在VS Code的Jupyter Notebook中无法生效：

%matplotlib inline
import matplotlib.pyplot as plt
fig = plt.figure(facecolor="#00FF0000")
ax = fig.add_axes([0, 0, 1, 1], facecolor="#FF000000")
plt.plot(range(10), [x**2 for x in range(10)])

QtConsole效果：

VS Code Notebook效果：

原因分析 #

1. 渲染后端差异：QtConsole使用Qt后端直接渲染Matplotlib的Figure对象，完整保留了图像的alpha（透明）通道；而Jupyter Notebook默认使用inline后端，会将图像转换为位图格式后嵌入文档，默认配置未启用透明通道保留。
2. Inline后端默认配置：%matplotlib inline的默认参数中，savefig.transparent为False，导致输出图像时丢弃了透明信息。
3. VS Code编辑器渲染行为：VS Code的Notebook输出区域可能会给所有嵌入图像添加默认白色背景，覆盖了图像本身的透明设置。

解决思路 #

• 修改Matplotlib全局配置：开启inline后端的透明保存选项，让输出图像自动保留alpha通道

  %matplotlib inline
  import matplotlib.pyplot as plt
  # 配置保存图像时保留透明通道
  plt.rcParams['savefig.transparent'] = True
  
  fig = plt.figure(facecolor="#00FF0000")
  ax = fig.add_axes([0, 0, 1, 1], facecolor="#FF000000")
  plt.plot(range(10), [x**2 for x in range(10)])
  

• 手动保存并加载透明图像：绕过inline后端的默认处理，直接生成带透明的PNG文件再显示

  import matplotlib.pyplot as plt
  from IPython.display import Image
  
  fig = plt.figure(facecolor="#00FF0000")
  ax = fig.add_axes([0, 0, 1, 1], facecolor="#FF000000")
  plt.plot(range(10), [x**2 for x in range(10)])
  
  # 保存为支持透明的PNG
  plt.savefig('transparent_plot.png', transparent=True)
  plt.close()  # 关闭原绘图，避免重复显示
  # 在Notebook中加载显示
  Image('transparent_plot.png')
  

• 调整VS Code Notebook设置：如果是编辑器层面的背景覆盖问题，可修改VS Code设置：

  1. 打开设置面板（快捷键Ctrl+,）
  2. 搜索notebook.output.background
  3. 将其值设置为transparent，让输出区域背景透明，从而显示图像本身的透明效果

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