Jupyter Lab无法显示JPG图片：代码仅输出尺寸无图像

• 缺少显示触发命令
  matplotlib的plt.imshow()仅完成图像绘制逻辑，不会主动触发显示动作。脚本环境下必须添加plt.show()才能弹出图像窗口。修改后的代码如下：

  # Display the photo and its shape
  print(img.shape)
  plt.imshow(img)
  plt.axis('off')
  plt.show()  # 新增该行触发图像显示
  

• 运行环境的交互式配置问题

  • 若在Jupyter Notebook/Lab中运行，需先设置matplotlib显示魔法命令，确保图像能自动渲染：

    %matplotlib inline  # 静态显示，适配Notebook场景
    # 或使用交互式模式：%matplotlib notebook
    

    该命令需在导入matplotlib或执行绘图代码前运行。
  • 若在普通.py脚本中运行，必须依赖plt.show()弹出独立窗口，无此命令则仅执行代码逻辑，不显示图像。

• 图像数据格式或范围异常
  matplotlib对输入图像数据有明确要求：

  • uint8类型数据需处于0-255区间；
  • float类型数据需处于0-1区间。
    可通过以下命令检查数据状态：

  print(img.dtype)       # 查看数据类型
  print(img.min(), img.max())  # 查看数值范围
  

  若数据不符合要求，可做如下转换：

  # 转换为uint8类型（适配0-255范围数据）
  img = img.astype('uint8')
  # 或归一化至0-1范围（适配float类型数据）
  img = (img - img.min()) / (img.max() - img.min())
  

• matplotlib后端配置错误
  若matplotlib使用非交互式后端（如agg），会导致图像无法显示。排查步骤如下：

  1. 查看当前后端：

     print(plt.get_backend())
     

  2. 若后端为agg，需在导入pyplot前切换到支持显示的后端：

     import matplotlib
     matplotlib.use('TkAgg')  # Windows/Linux常用后端
     # 或使用Qt后端：matplotlib.use('Qt5Agg')
     import matplotlib.pyplot as plt
     

  注：不同系统支持的后端不同，需根据自身环境选择适配项。

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