如何让IPython Notebook中Matplotlib绘图与Python脚本绘图完全一致？

核心原因 #

IPython Notebook默认的inline绘图后端，与Python脚本常用的Agg/TkAgg后端在渲染逻辑、默认画布尺寸、自动布局调整规则上存在差异，导致相同代码生成的图间距出现偏差。

具体解决方案 #

• 统一画布尺寸与关闭Notebook自动裁剪
  在Notebook和脚本中显式指定相同的画布大小，同时关闭Notebook的自动布局裁剪行为，避免默认调整破坏自定义布局：

  import matplotlib.pyplot as plt
  import numpy as np
  
  # 统一设置画布尺寸，确保两端输出一致
  plt.figure(figsize=(8, 6))
  # Notebook中关闭自动裁剪空白区域
  %config InlineBackend.print_figure_kwargs = {'bbox_inches': None}
  
  np.random.seed(19680801)
  
  plt.subplot(211)
  plt.imshow(np.random.random((100, 100)))
  plt.subplot(212)
  plt.imshow(np.random.random((100, 100)))
  
  plt.subplots_adjust(bottom=0.1, right=0.9, top=0.9)
  cax = plt.axes([0.85, 0.1, 0.075, 0.8])
  plt.colorbar(cax=cax)
  
  plt.show()
  

• 改用面向对象式API（更稳定）
  放弃pyplot的状态机模式，直接操作Figure和Axes对象，布局控制更精准，彻底规避环境差异带来的问题：

  import matplotlib.pyplot as plt
  import numpy as np
  
  np.random.seed(19680801)
  
  # 显式创建Figure和Axes对象，指定统一尺寸
  fig, (ax1, ax2) = plt.subplots(2, 1, figsize=(8, 6))
  im1 = ax1.imshow(np.random.random((100, 100)))
  im2 = ax2.imshow(np.random.random((100, 100)))
  
  # 统一调整子图布局参数
  fig.subplots_adjust(bottom=0.1, right=0.9, top=0.9)
  # 显式在Figure上添加颜色条轴
  cax = fig.add_axes([0.85, 0.1, 0.075, 0.8])
  fig.colorbar(im1, cax=cax)  # 复用其中一个图像的颜色条配置
  
  plt.show()
  

• 强制使用相同后端
  在脚本和Notebook中指定完全一致的绘图后端，消除渲染逻辑差异：

  # 脚本中直接添加
  plt.switch_backend('Agg')
  
  # Notebook中需先声明绘图模式再切换
  %matplotlib inline
  plt.switch_backend('Agg')
  

关键提示 #

• 永远不要依赖默认画布尺寸，始终显式设置figsize；
• 面向对象API的布局控制比pyplot状态机更稳定，适合跨环境一致渲染；
• Notebook的inline后端默认会自动裁剪空白区域，必须通过bbox_inches=None关闭该行为才能与脚本输出对齐。

内容的提问来源于stack exchange，提问作者John A. Dixon