如何在Jupyter QtConsole中让Matplotlib图像自适应窗口宽度？

我之前也碰到过QtConsole里Matplotlib图像不管原始尺寸都显示成固定大小的情况，核心原因是Matplotlib默认的figure尺寸是固定值，和QtConsole窗口宽度不匹配。下面给你几个实用的解决办法：

方法1：动态适配窗口宽度（最智能） #

通过Matplotlib的Qt后端获取当前QtConsole窗口宽度，自动计算合适的figure尺寸，让图像刚好填满窗口宽度，高度按图像比例自适应：

from astropy.io import fits
import matplotlib.pyplot as plt
from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg

# 读取FITS图像数据
hdul = fits.open("your_image.fits")
image_data = hdul[0].data
hdul.close()

# 获取QtConsole窗口宽度（转换为Matplotlib使用的英寸单位）
fig = plt.figure()
canvas = FigureCanvas(fig)
window_width_inch = canvas.parent().width() / fig.dpi

# 计算图像宽高比，设置figure尺寸
aspect_ratio = image_data.shape[0] / image_data.shape[1]
fig.set_size_inches(window_width_inch, window_width_inch * aspect_ratio)

# 显示图像，设置aspect='auto'让图像填满整个figure
plt.imshow(image_data, aspect="auto")
plt.colorbar()  # 可选，添加颜色条
plt.show()

方法2：全局修改Matplotlib默认figure尺寸 #

如果不想每次都写动态适配代码，可以直接设置Matplotlib的全局参数，让默认figure宽度接近QtConsole窗口：

import matplotlib.pyplot as plt

# 设置默认figure尺寸（根据你的QtConsole窗口调整数值，比如宽度设为12英寸）
plt.rcParams["figure.figsize"] = (12, 8)

# 之后正常读取和显示图像即可
from astropy.io import fits
image_data = fits.getdata("your_image.fits")
plt.imshow(image_data, aspect="auto")
plt.show()

这个方法的好处是一次设置全局生效，缺点是窗口大小改变后需要重新运行代码调整。

方法3：单张图像手动适配 #

如果只是针对个别图像调整，可以在显示时直接指定figure尺寸，配合aspect='auto'让图像填满figure：

from astropy.io import fits
import matplotlib.pyplot as plt

image_data = fits.getdata("your_image.fits")

# 手动设置figure尺寸，比如宽度设为10英寸，高度按比例计算
fig_width = 10
fig_height = fig_width * (image_data.shape[0] / image_data.shape[1])

plt.figure(figsize=(fig_width, fig_height))
plt.imshow(image_data, aspect="auto")
plt.show()

关键注意点 #

• 一定要设置aspect="auto"：默认的aspect='equal'会强制图像保持原始宽高比，但不会填满figure，这也是导致图像显示过小的原因之一。
• 如果你需要保留原始宽高比同时适配窗口，可以把aspect='auto'换成aspect='equal'，然后调整figure高度让图像完整显示在窗口内。

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