VS Code中Jupyter使用%matplotlib notebook时图表无法显示

问题本质 #

%matplotlib notebook是为原生Jupyter Notebook设计的交互式绘图后端，VS Code的Jupyter插件对该后端的兼容性较差。一旦执行该命令，内核会锁定此渲染模式，即使后续移除命令，也无法自动切换回默认的内嵌渲染模式，必须重置内核与窗口才能恢复正常。

替代方案 #

如果需要交互式绘图功能，推荐使用VS Code支持更完善的后端：

• 使用%matplotlib widget：这是VS Code官方推荐的交互式绘图后端，兼容性更好，无需重启即可切换，示例代码：

  %matplotlib widget
  import matplotlib.pyplot as plt
  
  plt.plot([1,2,3,4])
  plt.show()
  

• 若无需交互功能，保持默认的%matplotlib inline即可（通常无需手动添加，VS Code会自动启用），图表会直接嵌入单元格中。

快速恢复步骤 #

如果已经触发问题导致图表无法显示，可尝试以下步骤快速修复：

1. 在当前notebook中执行plt.switch_backend('inline')强制切换回内嵌后端
2. 点击VS Code右上角的"重启内核"按钮，重置当前Jupyter内核
3. 清除所有单元格输出后重新运行代码

注意事项 #

• 避免在VS Code的Jupyter环境中混用%matplotlib notebook与其他后端，切换后端前建议先重启内核
• 保持VS Code及Jupyter插件为最新版本，多数兼容性问题会随版本更新得到修复

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