Python PyQt5中如何通过PushButton按钮实现图片加载功能

前置说明 #

通过pyuic把.ui文件转成.py后，不要直接修改生成的界面文件，所有业务逻辑单独写在新文件中，通过继承的方式调用界面类，既避免重新转ui时代码被覆盖，也能解决大部分路径解析导致的图片加载失败问题。

实现逻辑 #

• 导入核心依赖：包含PyQt5的应用类、窗口类、文件对话框组件、图片像素图类，以及你自己通过pyuic转译生成的界面类
• 绑定点击信号：主窗口类初始化完成界面加载后，将PushButton的clicked点击信号绑定到自定义的图片加载槽函数
• 实现加载逻辑：调用系统文件选择框筛选图片格式，拿到有效文件路径后通过QPixmap加载图片，适配显示控件尺寸后渲染到界面上

可直接复用的参考代码 #

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QFileDialog
from PyQt5.QtGui import QPixmap
# 替换成你自己pyuic生成的界面文件导入路径、类名
from your_ui_file import Ui_MainWindow

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
        # 替换pushButton为你在Qt Designer中设置的按钮objectName
        self.pushButton.clicked.connect(self.load_selected_image)

    def load_selected_image(self):
        # 弹出文件选择框，仅显示支持的图片格式
        image_path, _ = QFileDialog.getOpenFileName(
            self,
            caption="选择要加载的图片",
            directory="",
            filter="图片格式 (*.png *.jpg *.jpeg *.bmp *.webp)"
        )
        # 用户点击取消选择时直接退出，不执行后续逻辑
        if not image_path:
            return
        
        # 加载选中的图片
        pixmap = QPixmap(image_path)
        # 替换image_display_label为你用来放图片的QLabel控件的objectName
        # 对图片做等比平滑缩放，适配显示控件大小，避免变形、显示不全
        self.image_display_label.setPixmap(
            pixmap.scaled(
                self.image_display_label.size(),
                aspectRatioMode=1,
                transformMode=1
            )
        )

if __name__ == "__main__":
    app = QApplication(sys.argv)
    win = MainWindow()
    win.show()
    sys.exit(app.exec_())

.ui转.py后图片加载失败排查清单 #

• 若你是在Qt Designer中直接给控件设置了图标/背景图，转py后找不到资源，是因为没有把qrc资源文件转成Python文件，执行命令pyrcc5 your_resource.qrc -o resource_rc.py，将生成的文件放到主脚本同目录即可
• 硬编码相对路径加载图片容易失效，原因是程序运行时工作目录和脚本存放目录不一定一致，若要固定加载本地相对路径图片，先通过os.path.abspath(__file__)获取脚本所在绝对路径再拼接文件路径
• 若图片加载后显示不全/变形，可在Qt Designer中选中显示图片的QLabel，勾选scaledContents属性，配合代码里的缩放逻辑即可正常显示

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