如何在macOS Retina显示屏上以原生分辨率通过Python显示NumPy数组中的图像

我明白你的痛点——在Mac的Retina屏上用Python显示NumPy图像，要做到原生分辨率确实不是简单调个dpi就行，得让窗口真正启用HiDPI模式。我之前也踩过这个坑，给你几个亲测有效的方案：

方案一：用PyQt5/PyQt6（最推荐，HiDPI支持完善） #

Qt框架对macOS的HiDPI支持做得很到位，只要开启对应设置，就能轻松实现原生分辨率显示。

首先安装依赖：

pip install pyqt5

然后是完整代码：

import sys
import numpy as np
from PyQt5.QtWidgets import QApplication, QLabel, QWidget, QVBoxLayout
from PyQt5.QtGui import QImage, QPixmap
from PyQt5.QtCore import Qt

# 这两行是关键！启用Qt的HiDPI支持
QApplication.setAttribute(Qt.AA_EnableHighDpiScaling)
QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps)

app = QApplication(sys.argv)

# 替换成你自己的NumPy图像数组（这里生成测试用的RGB图像）
your_image = np.random.randint(0, 255, (480, 640, 3), dtype=np.uint8)

# 将NumPy数组转换为Qt能识别的图像格式
height, width, channel = your_image.shape
bytes_per_line = channel * width
# 注意Qt的RGB格式对应NumPy的RGB通道顺序
q_image = QImage(your_image.data, width, height, bytes_per_line, QImage.Format_RGB888)

# 转成Pixmap并显示
pixmap = QPixmap.fromImage(q_image)
label = QLabel()
label.setPixmap(pixmap)
label.setAlignment(Qt.AlignCenter)

# 搭建窗口布局
window = QWidget()
layout = QVBoxLayout()
layout.addWidget(label)
window.setLayout(layout)
window.setWindowTitle("Retina原生分辨率图像")
window.show()

sys.exit(app.exec_())

运行后你会看到窗口里的图像是清晰的原生分辨率，不会有Retina屏常见的模糊问题。

方案二：Tkinter + PIL（轻量方案） #

如果不想引入Qt这样的重框架，用Tkinter结合PIL也能实现，关键是手动设置缩放因子适配Retina。

先安装依赖：

pip install pillow

代码示例：

import tkinter as tk
import numpy as np
from PIL import Image, ImageTk

root = tk.Tk()
root.title("Retina原生分辨率图像")

# 设置Retina缩放因子，Mac大部分Retina屏是2倍缩放，直接设2.0即可
root.tk.call('tk', 'scaling', 2.0)

# 替换成你的NumPy图像数组
your_image = np.random.randint(0, 255, (480, 640, 3), dtype=np.uint8)

# NumPy转PIL图像
pil_image = Image.fromarray(your_image)

# PIL转Tk可用的PhotoImage
tk_image = ImageTk.PhotoImage(pil_image)

# 显示图像
label = tk.Label(root, image=tk_image)
label.pack()

root.mainloop()

这个方案比较轻量，适合简单的图像显示需求，设置缩放因子后，Tkinter会以2倍分辨率渲染图像，适配Retina屏。

方案三：Matplotlib（如果习惯用它的话） #

你之前尝试Matplotlib没成功，大概率是没切换到支持HiDPI的backend，或者dpi设置不对。试试下面的配置：

import numpy as np
import matplotlib.pyplot as plt

# 关键：切换到支持HiDPI的Qt5Agg后端
plt.switch_backend('Qt5Agg')
# Mac Retina屏的dpi是默认72的2倍，所以设置为144
plt.rcParams['figure.dpi'] = 144

# 替换成你的NumPy图像数组
your_image = np.random.randint(0, 255, (480, 640, 3), dtype=np.uint8)

# 显示图像，去掉坐标轴更清爽
fig, ax = plt.subplots()
ax.imshow(your_image)
ax.axis('off')
plt.tight_layout()
plt.show()

之前用默认的MacOSX后端可能不支持HiDPI，换成Qt5Agg后，再设置正确的dpi，就能实现原生分辨率显示了。

备注：内容来源于stack exchange，提问作者N. Virgo